^of Modei^i^ U§pr& 



_ m m w- 



When yoirohange disjoin DfpJ^||$ 

you rrsystlfi^^jR^pii^t^ijg 

operating? 9y.^m. 'For sxarnpf^f 




mggm 

require%P£f|aET 



: - f. ■ . 

$5 ^ 



rv y& 



H-**, 



A cf}an§& 

Hoes n 








If f©u do not pre* ss R 



tie&e cond^^po, dafe tip 
id|s^tte m^j^ d^ffia^n 






M 



mjex 





To our customers . . . 

This package contains: 

• TRSDOS 6.2 diskette 

• TRSDOS 6.2 Hard Disk Initialization diskette 

• Model 4I4P Disk System Owner's Manual updated for 
TRSDOS 6.2 

• Replacement pages for the Model 4 Technical Reference 
Manual that update the software section to TRSDOS 6.2 

• Hard Disk System Startup for hard disk users, also updated for 
TRSDOS 6.2 

The Model 4I4P Disk System Owner's Manual has been improved and 
new commands have been added. If you have been using an earlier 
version of this manual, look for these major changes and additions in 
your new manual: 

CAT displays the directory for one or more drives. It works like 
DIR command With ALL parameter turned OFF. 

CLS clears the screen. 

HELP displays information about TRSDOS keywords. Using the 
HELP command's parameters, you can display additional 
information on the screen or printer. 

LOG allows you to change from one system diskette to another. 
It is very useful when you want to change system diskettes 
without resetting the system. 

TOF advances the printer to the top of the next page before 
printing. (TOF can only be used with certain printers.) 

FLOPPY/DCT lets you define a logical drive as a floppy drive. 
Use it with the SYSTEM command. 

Parameters have been added to the DIR, FORMAT, SYSTEM, and 
SETCOM commands. CLICK/FLT has an additional parameter, 
"CHAR." 

With TRSDOS 6.2 you can create an Immediate Execution Program 
(IEP). Once you create an IEP, you can l oad an d run it at the 
TRSDOS Ready prompt by pressing CD (IWTfff) . 

The cursor has been changed from a double underline to a single 
underline. 

The default step rate has been changed to 6ms. 

Pressing (CTffD (T) at the TRSDOS Ready prompt repeats the 
previous TRSDOS command. 



Note to non-U. S.A. users: Changing between 50 and 60 HERTZ is 
now done with the SYSTEM command instead of the HERTZ/JCL file. 

Thank you! 

Radio Shack 

A Division of Tandy Corporation 

TSA 875-9527 

TAP 875-9306 



Upgr^lM to TMDQ^ (5,2,0 Floppy „ 

Before you upgrade your diskettes, make backup copies of the TRSDOS Version 
6.2.0 master diskette and your application diskettes. Perform all procedures on 
til ese backup copies. '"•■'■.. • ' ■ •-•.-- 

You must have two disk drives to upgrade your applications and data diskettes to TRSDGS 
6.2.0. If you have a single drive system or wish additional assistance, contact your Radio Shack 
dealer. V" ,.,. , 

If your applications packages are on TRSDOS Version 6.0.x, upgrade them to Version 6.1.x 
before upgrading them to Version 6.2.0. 

Note: When you change disks in Drive 0, you must press RESET if the diskettes contain 
different versions of the operating system. 

The following packages are backup-limited diskettes, and therefore do NOT upgrade them: 

PFS Report Cat. No. 26-1517 

PFS File Cat. No. 26-1518 

Some applications programs are distributed on data diskettes. To take advantage of the 
increased speed with Version 6.2.0 with these packages as well as your own data diskettes, 
perform Step 1 and then continue with Step 11. 

Procedure for upgrading diskettes: 

1. Start up your system with a Version 6.2.0 diskette in Drive 0. 

2. Insert a write-enabled copy of your application diskette in Drive 1. 

3. At the TRSDOS Ready prompt, type: 

AUTO ?:1 (ENTER) 

If TRSDOS displays a blank line, proceed to Step 4. If TRSDOS displays an AUTO 
command, write it down. 

4. At the TRSDOS Ready prompt, type: 

PURGE SYS13/SYS;1 (S,Q = N) CESTEHD 

If TRSDOS does not display "Purging: SYS13/SYS-.1", be sure you entered the command 
correctly. If not, repeat the command. If you entered the command correctly, the file has 
already been removed and you may proceed to Step 5. 

5. At the TRSDOS Ready prompt, type: 

PURGE HERTZ/ JCL:1 (Q = N) CEHTERD 

If TRSDOS does not display "Purging: HERTZ/JCL1", be sure you entered the command 
correctly. If not, repeat the command. If you entered the command correctly, proceed to 



6. At the TRSDOS Ready prompt, type: 



PURGE HERZ50/JCL; ; 1 {Q = N) (ENTER) 

If TRSDOS does not display "Purging: HERZ50/JCL:1", Demure you entered the command 
correctly. If not, repeat the command. If you entered the command correctly, proceed to 
Step 7. 

7. At the TRSDOS Ready prompt, type: r 



FREE :1 (ENTER) 

If the amount of free space is more than 6.00K, proceed to Step 8. If the amount of free 
space is |eps than 6.00K, type: ,,,,. , 



PURGE BACKUP/CMD:1 (I.Q = N) fE~NTTRl 
8. At the TRSDOS Ready prompt, type: 



BACKUP :0 :1 (S,I,OLD) CE_N_T_E_RJ 

9. If your disk did not have an AUTO command in Step 3, proceed to Step 10. At the 
TRSDOS. Heady prompt, type: 

AUTO :1 command from Step 3 

10. CONFIG/SYS files are not copied to the upgraded diskette in the BACKUP procedure. You 
must use SYSGEN to create a new CONFIG/SYS file. If you have added your own 
CONFIG/SYS file, repeat that procedure at this point. If you have not added a 
CONFIG/SYS file or are not upgrading the following applications, proceed to Step 11. 

W-2 Writer Cat. No. 26-1539 

General Ledger Cat. No. 26-1540 

Accounts Receivable Cat. No. 26-1541 

Accounts Payable Cat. No. 26-1542 

Payroll Cat. No. 26-1543 

Invoice Writer Cat. No. 26-1544 

Videotex Plus Cat. No. 26-1598 

For Videotex Plus, at the TRSDOS Ready prompt, type: 



SET *CL TO COM/DVR (ENTER) 
SYSGEN mWIVEal) (ENTER) 

For the other applications listed above, at the TRSDOS Ready prompt, type: 



SET *FF TO FORMS/FLT (ENTER) 
FILTER *PR *FF (ENTER) 



SYSGEN mRIVE=l) (ENTER) 



11. Insert a blank diskette in Drive 1. At the TRSDOS Ready prompt, type: 

FORMAT :1 (Q a N) fE~NTE~R~) 

12. When formatting is complete, type: 

BACKUP :0 :1 (X) ( E N T E Rl 

When TRSDOS prompts you to insert the source diskette, insert your data diskette or 
upgraded application diskette in Drive and press (ENTER ). 

When BACKUP is complete, remove the diskette in Drive 1, label it as your master diskette, 
and put it in a safe place. If you purged BACKUP in Step 7, you must use Steps 11 and 12 to 
BACKUP your application diskettes. 



RadB$/hMK 
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READ jVI£j FIRST 

All computer software is subject to change, correction, or improvement as the 
manufacturer receives customer comments and experiences. Radio Shack has 
established a system to keep you immediately informed of any reported prob- 
lems with this software, and the solutions. We have a customer service network 
including representatives in many Radio Shack Computer Centers, and a large 
group in Fort Worth, Texas, to help with any specific errors you may find in 
your use of the programs. We will also furnish information on any improve- 
ments or changes that are "cut in" on later production versions. 



To take advantage of these services, you must do three things: 

(1) Send in the postage-paid software registration card included in this manual 
immediately. (Postage must be affixed in Canada.) 

(2) If you change your address, you must send us a change of address card 
(enclosed), listing your old address exactly as it is currently on file with us. 

(3) As we furnish updates or "patches", and you update your software, you 
must keep an accurate record of the current version numbers on the logs 
below. (The version number will be furnished with each update.) 

Keep this card in your manual at all times, and refer to the current version 
numbers when requesting information or help from us. Thank you. 



APPLICATIONS SOFTWARE 
VERSION LOG 



OP. SYSTEM 
VERSION LOG 



Replacement Pages 

for 

Model 4 Technical Reference Manual 



Attached are replacement pages for the Model 4 Technical Reference Manual 
to update the Software Section to TRSDOS 6.2. 

If your Model 4 Technical Reference Manual has already been updated, it will 
have the following note on the copyright page: 

Software Section updated to TRSDOS 6.2 

If your manual has this note, you do not need the replacement pages. If it 
does not, insert the pages into your manual. 

If you have not purchased a Model 4 Technical Reference Manual, but may in 
the future, keep these pages. 

You may purchase the Model 4 Technical Reference Manual through your Ra- 
dio Shack dealer. 



Thank You 



Radio IfeaeH 

A DIVISION OF TANDY CORPORATION 
FORT WORTH, TEXAS 76102 



TSA 8759526 
TAP 8749530 
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VII 



Utility Programs 



In TRSDOS Version 6.2, this overlay contains the message "No ECI is present 
at SYS1 3" if you have not implemented an Extended Command Interpreter 
(ECI) or an Immediate Execution Program (IEP). You may purge this overlay if 
you do not intend to use an ECI or an IEP. See Appendix F, Using SYS13, for 
more information. 



BACKUP — Used to duplicate data from one disk to another. 

COMM — A communications package for use with the RS-232C 

hardware. 

CON V — Used to copy files from Model III TRSDOS to TRSDOS Version 

6. 

DOS/HLP — (Version 6.2 only) The data file used with the HELP utility. 

FORMAT — Used to put track, sector, and directory information on a disk. 

HELP/CMD — (Version 6.2 only) Used to provide on-line information about 
the TRSDOS commands. 

LOG — Used to log in a double-sided diskette in Drive 0. Also updates 

the Drive Code Table information as with the DEVICE library 
command. 

PATCH — Used to make changes to existing files. 

REPAIR — Used to correct certain information on non-TRSDOS format- 
ted diskettes. 

TAPE100 — A disk/tape, tape/disk utility for cassette tape operations with 
theTRS-80 Model 100. 



Device Driver Programs 



COM/DVR 
FLOPPY/DCT 

JL/DVR 



- The RS-232C communications driver. 

■ Configures floppy drives in the system. Not needed with a 
floppy-only system. 

■ The Joblog driver program. 



Filter Programs 



MEMDISK/DCT — Used to establish a pseudo floppy drive in memory. 



CLICK/FLT — Produces a short tone as each key is pressed. 

FORMS/FLT — Used to select printer parameters and perform character 
translation. 

KSM/FLT — The Keystroke Multiply feature, which allows the assigning 

of user-determined phrases to alphabetic keys. 



Creating a Minimum Configuration Disk 



All files except certain /SYS files may be purged from your Drive disk. Addi- 
tionally, if you place the needed /SYS files in high memory with the SYSTEM 
(SYSRES) command, it will be possible to run with a minimum configuration 
disk in Drive after booting the system. Keep the following points in mind when 
purging system files: 

• For operation, SYS files 1, 2, 3, 4, 10, and 12 should remain on the Drive 
disk or be resident in memory. 
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• SYS2 must be on the system disk if a configuration file is to be loaded. 

• SYS11 must be present only if any JCL files will be used. 

• All three libraries (SYS files 6, 7, and 8) may be purged if no library com- 
mand will be used. 

• SYS5 and SYS9 may be purged if the system DEBUG package is not 
needed. 

• SYS0 may be removed from any disk not used for booting. 

• SYS 11 (the JCL processor) and SYS6 (containing the DO library com- 
mand) must both be on the disk if the DO command is to be used. Also, 
if you remove SYS6, you may as well remove SYS11. 

• SYS13 may be removed if you have not implemented an ECI, an IEP file, 
or if you do not intend to use them. 

The presence of any utility, driver, or filter program is dependent upon your in- 
dividual needs. You can save most of the TRSDOS features in a configuration 
file using the SYSTEM (SYSGEN) command, so the driver and filter programs 
will not be needed in run time applications. If you intend to use the HELP utility, 
your disk must contain the DOS/HLP file. 

The owner (update) passwords for TRSDOS files are as follows: 

File Type 

System files 
Filter files 
Driver files 
Utility files 
BASIC 

BASIC overlays 
CONFIG/SYS 
Drive Code Table 
Initializer 



Extension 


Owner Password 


(/SYS) 


LSI DOS 


(/FLT) 


FILTER 


(/DVR) 


DRIVER 


(/CMD) 


UTILITY 




BASIC 


(/OV$) 


BASIC 




CCC 


(/DCT) 


UTILITY 
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5 Drive Access 



Drive Code Table (DCT) 



TRSDOS uses a Drive Code Table (DCT) to interface the operating system with 
specific disk driver routines. Note especially the fields that specify the allocation 
scheme for a given drive. This data is essential in the allocation and accessi- 
bility of file records. 

The DCT contains eight 10-byte positions — one for each logical drive des- 
ignated 0-7. TRSDOS supports a standard configuration of two-floppy 
drives. You may have up to four floppy drives. This is the default initializa- 
tion when TRSDOS is loaded. 

Here is the Drive Code Table layout: 

DCT + 

This is the first byte of a 3-byte vector to the disk I/O driver routines. This byte 
is normally X'C3,' If the drive is disabled or has not been configured (see the 
SYSTEM command in the Disk System Owner's Manual), this byte is a RET 
instruction (X'C9'), 

DCT + 1andDCT+2 

Contain the entry address of the routines that drive the physical hardware. 

DCT + 3 

Contains a series of flags for drive specifications. 

Bit 7 — Set to "1" if the drive is software write protected, "0" if it is not, (See 
the SYSTEM command in the Disk System Owner's Manual.) 

Bit 6 — Set to "1" for DDEN (double density), or "0" for SDEN (single 
density). 

Bit 5— Set to "1" if the drive is an 8" drive. Set to "0" if it is a SW drive. 

Bit 4 — A "1" causes the selection of the disk's second side. The first side 
is selected if this bit is "0," This bit value matches the side indicator 
bit in the sector header written by the Floppy Disk Controller 
(FDC). 

Bit 3 — A "1" indicates a hard drive (Winchester), A "0" denotes a floppy 
drive (5 1 /4" or 8"). 

Bit 2 — Indicates the time delay between selection of a 5 1 /4" drive and the 
first poll of the status register. A "1" value indicates 0,5 second and 
a "0" indicates 1.0 second. See the SYSTEM command in the Disk 
System Owner's Manual for more details. 

If the drive is a hard drive, this bit indicates either a fixed or remov- 
able disk; "1" = fixed, "0" = removable. 

Bits 1 and — Contain the step rate specification for the Floppy Disk Con- 
troller, (See the SYSTEM command in the Disk System Owner's 
Manual.) In the case of a hard drive, this field may indicate the drive 
address (0-3). 

DCT + 4 

Contains additional drive specifications. 

Bit 7 — (Version 6,2 only) If "1 ", no @CKDRV is done when accessing the 
drive. If an application opens several files on a drive, this bit can be 
set to speed I/O on that drive after the first successful open is 

performed, 
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In versions prior to TRSDOS 6.2, this bit is reserved for future use. 
In order to maintain compatibility with future releases of TRSDOS, 
do not use this bit. 

Bit 6 — If "1", the controller is capable of double-density mode. 

Bit 5— "1" indicates that this is a 2-sided floppy diskette; "0" indicates a 
1-sided floppy disk. Do not confuse this bit with Bit 4 of DCT + 3. 
This bit shows if the disk is double-sided; Bit 4 of DCT + 3 tells the 
controller what side the current I/O is to be on. 

If the hard drive bit (DCT + 3, Bit 3) is set, a "1" denotes double the 
cylinder count stored in DCT + 6. (This implies that a logical cylin- 
der is made up of two physical cylinders.) 

Bit 4 — If "1," indicates an alien (non-standard) disk controller. 

Bits 0-3— Contain the physical drive address by bit selection (0001, 0010, 
0100, and 1000 equal logical Drives 0, 1, 2, and 3, respectively, in 
a default system). The system supports a translation only where no 
more than one bit can be set. 

If the alien bit (Bit 4) is set, these bits may indicate the starting head 
number. 

DCT + 5 

Contains the current cylinder position of the drive. It normally stores a copy of 
the Floppy Disk Controller's track register contents whenever the FDC is 
selected for access to this drive. It can then be used to reload the track register 
whenever the FDC is reselected. 

If the alien bit (DCT + 4, Bit 4) is set, DCT + 5 may contain the drive select code 
for the alien controller. 

DCT + 6 

Contains the highest numbered cylinder on the drive. Since cylinders are num- 
bered from zero, a 35-track drive is recorded as X'22' a 40-track drive as X'27/ 
and an 80-track drive as X'4F' If the hard drive bit (DCT + 3, Bit 3) is set, the true 
cylinder count depends on DCT + 4, Bit 5. If that bit is a "1," DCT + 6 contains 
only half of the true cylinder count. 

DCT + 7 

Contains allocation information. 

Bits 5-7 — Contain the number of heads for a hard drive. 

Bits 0-4 — Contain the highest numbered sector relative to zero. A 10- 
sector-per-track drive would show X'09.' If DCT + 4, Bit 5 indicates 
2-sided operation, the sectors per cylinder equals twice this 
number. 

DCT + 8 

Contains additional allocation information. 

Bits 5-7— Contain the number of granules per track allocated in the for- 
matting process. If DCT + 4, Bit 5 indicates 2-sided operation, the 
granules per cylinder equals twice this number. For a hard drive, 
this number is the total granules per cylinder. 

Bits 0-4 — Contain the number of sectors per granule that was used in the 
formatting operation. 

DCT + 9 

Contains the number of the cylinder where the directory is located. For any 
directory access, the system first attempts to use this value to read the direc- 
tory. If this operation is unsuccessful, the system examines the BOOT granule 
(cylinder 0) directory address byte. 
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Bytes DCT + 6, DCT + 7, and DCT + 8 must relate without conflicts. That is, the 
highest numbered sector ( + 1 ) divided by the number of sectors per granule 
( + 1 ) must equal the number of granules per track ( + 1 ). 



Disk I/O Table 



TRSDOS interfaces with hardware peripherals by means of software drivers. 
The drivers are, in general, coupled to the operating system through data 
parameters stored in the system's many tables. In this way, hardware not cur- 
rently supported by TRSDOS can easily be supported by generating driver soft- 
ware and updating the system tables. 

Disk drive sub-systems (such as controllers for SW drives, 8" drives, and hard 
disk drives) have many parameters addressed in the Drive Code Table (DCT). 
Besides those operating parameters, controllers also require various com- 
mands (SELECT SECTOR READ, SECTOR WRITE, and so on) to control the 
physical devices. TRSDOS has defined command conventions to deal with 
most commands available on standard Disk Controllers. 

The function value (hexadecimal or decimal) you wish to pass to the driver 
should go in register B. The available functions are: 



Hex Dec 



Function 



Operation Performed 



X'OO" 





DCSTAT 


X'01" 


1 


SELECT 


X'02' 


2 


DCINIT 


X'03' 


3 


DCRES 


X'04' 


4 


RSTOR 


X'05" 


5 


STEPI 


X'06" 


6 


SEEK 


X'07" 


7 


TSTBSY 


X'08" 


8 


RDHDR 


X'09' 


9 


RDSEC 


X'OA" 


10 


VRSEC 


X'OB' 


11 


RDTRK 


X'OC 


12 


HDFMT 


X'OD' 


13 


WRSEC 


X'OE" 


14 


WRSYS 


X'OF 


15 


WRTRK 


Function codes 


X'10'toX'F 



Test to see if drive is assigned in DCT 
Select a new drive and return status 
Set to cylinder 0, restore, set side 
Reset the Floppy Disk Controller 
Issue FDC RESTORE command 
Issue FDC STEP IN command 
Seek a cylinder 

Test to see if requested drive is busy 
Read sector header information 
Read sector 

Verify if the sector is readable 
Issue an FDC track read command 
Format the device 
Write a sector 

Write a system sector (for example, directory) 
Issue an FDC track write command 
are reserved for future use. 



Directory Records (DIREC) 



The directory contains information needed to access all files on the disk. The 
directory records section is limited to a maximum of 32 sectors because of 
physical limitations in the Hash Index Table. Two additional sectors in the direc- 
tory cylinder are used by the system for the Granule Allocation Table and the 
Hash Index Table. The directory is contained on one cylinder. Thus, a 1 0-sector- 
per-cylinder formatted disk has, at most, eight directory sectors. See the sec- 
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Sectors 




User Files 


User 


per 


Directory 


on Data 


Files on 


Cylinder 


Sectors 


Disk** 


SYS Disk 


10 


8 


62 


48 


20 


18 


142 


128 


18 


16 


126 


112 


36 


32 


254 


240 


16 


14 


110 


96 


32 


30 


238 


224 


30 


28 


222 


208 


60 


32 


254 


240 



tion on the Hash Index Table for the formula to calculate the number of directory 
sectors. 

A directory record is 32 bytes in length. Each directory sector contains eight 
directory records (256/32 = 8). On system disks, the first two directory records 
of the first eight directory sectors are reserved for system overlays. The total 
number of files possible on a disk equals the number of directory sectors times 
eight (since 256/32 = 8). The number available for use is reduced by 16 on sys- 
tem disks to account for those record slots reserved for the operating system. 
The following table shows the directory record capacity (file capacity) of each 
format type. The dash suffix (-1 or -2) on the items in the density column rep- 
resents the number of sides formatted (for example, SDEN-1 means single 
density, 1-sided). 



5" SDEN-1 
5" SDEN-2 
5" DDEN-1 
5" DDEN-2 
8" SDEN-1 
8" SDEN-2 
8" DDEN-1 
8" DDEN-2 
Hard Disk* 

*Hard drive format depends on the drive size and type, as well as the user's 
division of the physical drive into logical drives. After setting up and format- 
ting the drive, you can use the FREE library command to see the available 

files. 
"Note: Two directory records are reserved for BOOT/SYS and DIR/SYS, and 

are not included in the figures for this column. 

TRSDOS Version 6 is upward compatible with other TRSDOS 2.3 compatible 
operating systems in its directory format. The data contained in the directory 
has been extended. An SVC is included to either display an abbreviated direc- 
tory or place its data in a user-defined buffer area. For detailed information, see 
the @DODIR and @RAMDIR SVCs. 

The following information describes the contents of each directory field: 

DiR + S 

Contains all attributes of the designated file. 

Bit 7 — If "0," this flag indicates that the directory record is the file's primary 
directory entry (FPDE). If "1," the directory record is one of the file's 
extended directory entries (FXDE). Since a directory entry can 
contain information on up to four extents (see notes on the extent 
fields, beginning with DIR + 22), a file that is fractured into more 
than four extents requires additional directory records. 

Bit 6 — Specifies a SYStem file if "1," a nonsystem file if "0." 

Bit 5— If set to "1," indicates a Partition Data Set (PDS) file. 

Bit 4 — Indicates whether the directory record is in use or not. If set to "1," 
the record is in use. If "0," the directory record is not active, 
although it may appear to contain directory information. In contrast 
to some operating systems that zero out the directory record when 

you remove a file, TRSDOS only resets this bit to zero. 

Bit 3— Specifies the visibility. If "1," the file is INVisible to a directory dis- 
play or other library function where visibility is a parameter. If a "0," 
then the file is Visible. (The file can be referenced if specified by 
name by an @INIT or ©OPEN SVC.) 
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Bits 0-2-— Contain the USER protection level of the file. The 3-bit binary 
value is one of the following: 

= FULL 2 = RENAME 4 = UPDATE 6 = EXECUTE 

1= REMOVE 3 = WRITE 5 = READ 7 = NO ACCESS 

DIR + 1 

Contains various file flags and the month field of the packed date of last 
modification. 

Bit 7— Set to "1" if the file was "CREATEd" (see CREATE library com- 
mand in the Disk System Owner's Manual). Since the CREATE 
command can reference a file that is currently existing but non- 
CREATEd, it can turn a non-CREATEd file into a CREATEd one. 
You can achieve the same effect by changing this bit to a "1." 

Bit 6 — If set to "1," the file has not been backed up since its last modifica- 
tion. The BACKUP utility is the only TRSDOS facility that resets 
this flag. It is set during the close operation if the File Control Block 
(FCB + 0, Bit 2) shows a modification of file data. 

Bit 5 — If set to "1," indicates a file in an open condition with UPDATE 
access or greater. 

Bit 4 — If the file was modified during a session where the system date was 
not maintained, this bit is set to "1." This specifies that the packed 
date of modification (if any) stored in the next three fields is not the 
actual date the modification occurred. If this bit is "1," the directory 
command displays plus signs ( + ) between the date fields if you 
request the (A) option. 

Bits 0-3 — Contain the binary month of the last modification date. If this 

field is a zero, DATE was not set when the file was established or 

since if it was updated. 

DIR + 2 

Contains the remaining date of modification fields. 

Bits 3-7 — Contain the binary day of last modification. 

Bits 0-2 — Contain the binary year minus 80. For example, 198© is coded 
as 000, 1981 as 001, 1982 as 010, and so on. 

dir +3 

Contains the end-of-file offset byte. This byte and the ending record number 
(ERN) form a pointer to the byte position that follows the last byte written. This 
assumes that programmers, interfacing in machine language, properly main- 
tain the next record number (NRN) offset pointer when the file is closed. 

DIR + 4 

Contains the logical record length (LRL) specified when the file was generated 
or when it was later changed with a CLONE parameter. 

DIR + 5 through DIR + 12 

Contain the name field of the filespec. The filename is left justified and padded 
with trailing blanks. 

DIR + 13 through DIR + 15 

Contain the extension field of the filespec. It is left justified and padded with 
trailing blanks. 

DIR + 16 and DIR + 17 

Contain the OWNER password hash code. 

DIR + 18 and DIR + 19 

Contain the USER password hash code. The protection level in DSR + is asso- 
ciated with this password. 

1&7 



DlR + 20andDIR + 21 

Contain the ending record number (ERN), which is based on full sectors. If the 
ERN is zero, it indicates that no writing has taken place (or that the file was not 
closed properly). If the LRL is not 256, the ERN represents the sector where the 
EOF occurs. You should use ERN minus 1 to account for a value relative to sec- 
tor of the file. 

D!R + 22and DIR + 23 

This is the first extent field. Its contents indicate which cylinder stores the first 
granule of the extent, which relative granule it is, and how many contiguous 
grans are in use in the extent. 

DIR + 22 — Contains the cylinder value for the starting gran of that extent. 

DIR + 23, Bits 5-7 — Contain the number of the granule in the cylinder indi- 
cated by DIR + 22 which is the first granule of the file for that 
extent. This value is relative to zero ("0" denotes the first gran, 
"1" denotes the second, and so on). 

DIR + 23, Bits 0-4 — Contain the number of contiguous granules, relative 
to ("0" denotes one gran, "1" denotes two, and so on). Since 
the field is five bits, it contains a maximum of X'1 F or 31, which 
represents 32 contiguous grans. 

DIR + 24andDIR + 25 

Contain the fields for the second extent. The format is identical to that for 
Extent 1. 

DIR + 26andDIR + 27 

Contain the fields for the third extent. The format is identical to that for Extent 1. 

DIR -28 and DIR + 29 

Contain the fields for the fourth extent. The format is identical to that for 
Extent 1. 

DIR + 30 

This is a flag noting whether or not a link exists to an extended directory record. 
If no further directory records are linked, the byte contains X'FF A value of X'FE' 
in this byte establishes a link to an extended directory entry. (See "Extended 
Directory Records" below.) 

DIR + 31 

This is the link to the extended directory entry noted by the previous byte. The 
link code is the Directory Entry Code (DEC) of the extended directory record. 
The DEC is actually the position of the Hash Index Table byte mapped to the 
directory record. For more information, see the section "Hash Index Table!' 

Extended Directory Records 

Extended directory records (FXDE) have the same format as primary directory 
records, except that only Bytes 0, 1, and 21-31 are utilized. Within Byte 0, only 
Bits 4 and 7 are significant. Byte 1 contains the DEC of the directory record of 
which this is an extension. An extended directory record may point to yet 
another directory record, so a file may contain an "unlimited" number of extents 
(limited only by the total number of directory records available). 



Granule Allocation Table (GAT) 



The Granule Allocation Table (GAT) contains information on the free and 
assigned space on the disk. The GAT also contains data about the formatting 
used on the disk. 
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A disk is divided into cylinders (tracks) and sectors. Each cylinder has a spec- 
ified number of sectors. A group of sectors is allocated whenever additional 
space is needed. This group is called a granule. The number of sectors per 
granule depends on the total number of sectors available on a logical drive. The 
GAT provides for a maximum of eight granules per cylinder. 

In the GAT bytes, each bit set to "1" indicates a corresponding granule in use 
(or locked out). Each bit reset to "0" indicates a granule free to be used. In a 
GAT byte, bit corresponds to the first relative granule, bit 1 to the second rel- 
ative granule, bit 2 the third, and so on. A 5 1 /V' single density diskette is format- 
ted at 10 sectors per cylinder, 5 sectors per granule, 2 granules per cylinder. 
Thus, that configuration uses only bits and 1 of the GAT byte. The remainder 
of the GAT byte contains all 1's, denoting unavailable granules. Other formatting 
conventions are as follows: 





Sectors 


Sectors 


Granules 


Maximum 




per 


per 


per 


No. of 




Cylinder 


Granule 


Cylinder 


Cylinders 


5" SDEN 


10 


5 


2 


80 


5" DDEN 


18 


6 


3 


80 


8" SDEN 


16 


8 


2 


77 


8" DDEN 


30 


10 


3 


77 


5-MEG HARD* 


32 


16 


8 


153 



*Hard drive format depends on the drive size and type, as well as the user's divi- 
sion of the drive into logical drives. These values assume that one physical 
hard disk is treated as one logical drive. 

The above table is valid for single-sided disks. TRSDOS supports double-sided 
operation if the hardware interfacing the physical drives to the CPU allows it. A 
two-headed drive functions as a single logical drive, with the second side as a 
cylinder-for-cylinder extension of the first side. A bit in the Drive Code Table 
(DCT + 4, Bit 5) indicates one-sided or two-sided drive configuration. 

A Winchester-type hard disk can be divided by heads into multiple logical 
drives. Details are supplied with Radio Shack drives. 

The Granule Allocation Table is the first relative sector of the directory cylinder. 
The following information describes the layout and contents of the GAT 

GAT + XW through GAT + X'5F' 

Contains the free/assigned table information. GAT + corresponds to cylinder 
0, GAT+ 1 corresponds to cylinder 1, GAT + 2 corresponds to cylinder 2, and so 
on. As noted above, bit of each byte corresponds to the first granule on the 
cylinder, bit 1 to the second granule, and so on. A value of "1" indicates the 
granule is not available for use. 

GAT + XW through GAT + X'BP 

Contains the available/locked out table information. It corresponds cylinder for 
cylinder in the same way as the free/assigned table. It is used during mirror- 
image backups to determine if the destination diskette has the proper capacity 
to effect a backup of the source diskette. This table does not exist for hard 
disks; for this reason, mirror-image backups cannot be performed on hard disk. 

GAT + X'C0' through GAT + X'CA' 

Used in hard drive configurations; extends the free/assigned table from X'00' 
through X'CA'.Hard drive capacity up to 203 (0-202) logical or 406 physical cyl- 
inders is supported, 

GAT + X'CB' 

Contains the operating system version that was used in formatting the disk. For 
example, disks formatted under TRSDOS 6.1 have a value of X'61' contained in 
this byte. It is used to determine whether or not the disk contains all of the 
parameters needed for TRSDOS operation. 
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GAT + X'CC 

Contains the number of cylinders in excess of 35. it is used to minimize the time 
required to compute the highest numbered cyiinder formatted on the disk. It is 
excess 35 to provide compatibility with alien systems not maintaining this byte. 
If you have a disk that was formatted on an alien system for other than 35 cyl- 
inders, this byte can be automatically configured by using the REPAIR utility. 
(See the section on the REPAIR utility in the Disk System Owner's Manual.) 

GAT + X'CD' 

Contains data about the formatting of the disk. 

Bit 7— If set to "1," the disk is a data disk. If "0," the disk is a system disk. 

Bit 6 — If set to "1," indicates double-density formatting. If "0," indicates 

single-density formatting. 

Bit 5— If set to "1," indicates 2-sided disk. If "0," indicates 1-sided disk. 
Bits 3-4 -—Reserved. 

Bits 0-2 — Contain the number of granules per cylinder minus 1. 
GAT+X ! CE' and GAT+X'CP 

Contain the 16-bit hash code of the disk master password. The code is stored 

in standard low-order, high-order format. 

GAT+XW through GAT+X'D7' 

Contain the disk name. This is the name displayed during a FREE or DIR oper- 
ation. The disk name is assigned during formatting or during an ATTRIB disk 
renaming operation. The name is left justified and padded with blanks. 

GAT+X'D8' through GAT + X'DF* 

Contain the date that the diskette was formatted or the date that it was used as 

the destination in a mirror image backup operation in the format mm/dd/yy. 

GAT+X'ES' through GAT+X'FF 

Reserved for system use. 

in Version 6.2: 

GAT + X'Ef through GAT + X'F4' 

Reserved for system use. 

GAT + X'F5' through GAT + X'FF' 

Contain the Media Data Block (MDB). 

GAT + X'F5' through GAT + X'F8' — the identifying header. These four 
bytes contain a 3 (X'03'), followed by the letters LSI (X'4C',X'53',X'49'). 

GAT + X'F8' through GAT + X'FF' — the last seven bytes of the DCT in use 
when the media was formatted. FORMAT, MemDISK, and TRSFORM4 in- 
stall this information. See Drive Control Table (DCT) for more information 

on these bytes. 



Hash Index Table (HIT) 



The Hash Index Table is the key to addressing any file in the directory. It pin- 
points the location of a file's directory with a minimum of disk accesses, keeping 

overhead iow and providing rapid file access. 

The system's procedure is to construct an 11-byte filename/extension field. The 
filename is left-justified and padded with blanks. The file extension is then 
inserted and padded with blanks; it occupies the three least significant bytes of 
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the 11-byte field. This field is processed through a hashing algorithm which pro- 
duces a single byte value in the range X*§1' through X'FR (A hash value of XW 
indicates a spare HIT position.) 

The system then stores the hash code in the Hash index Table (HIT) at a posi- 
tion corresponding to the directory record that contains the file's directory. Since 
more than one 11-byte string can hash to identical codes, the opportunity for 
"collisions" exists. For this reason, the search algorithm scans the HIT for a 
matching code entry, reads the directory record corresponding to the matching 
HIT position, and compares the filename/extension stored in the directory with 
that provided in the file specification. If both match, the directory has been 
found, if the two fields do not match, the HIT entry was a collision and the algo- 
rithm continues its search from the next HIT entry. 

The position of the HIT entry in the hash table is called the Directory Entry Code 
(DEC) of the file. All files have at least one DEC. Files that are extended beyond 
four extents have a DEC for each extended directory entry and use more than 
one filename slot. To maximize the number of file slots available, you should 
keep your files below five extents where possible. 

Each HIT entry is mapped to the directory sectors by the DEC'S position in the 
HIT. Think of the HIT as eight rows of 32-byte fields. Each row is mapped to one 
of the directory records in a directory sector: The first HIT row is mapped to the 
first directory record, the second HIT row to the second directory record, and so 
on. Each column of the HIT field (0-31 ) is mapped to a directory sector. The first 
column is mapped to the first directory sector in the directory cylinder (not 
including the GAT and HIT). Therefore, the first column corresponds to sector 
2, the second column to sector 3, and so on. The maximum number of HIT col- 
umns used depends on the disk formatting according to the formula: 
N = number of sectors per cylinder minus two, up to 32. 

The following chart shows the correlation of the Hash Index Table to the direc- 
tory records. Each byte value shown represents the position in the HIT. This 
position value is the DEC. The actual contents of each byte is either a X(00) 
indicating a spare slot, or the 1-byte hash code of the file that occupies the cor- 
responding directory record. 



Row1 


00 
10 


01 
11 


02 
12 


03 

13 


04 
14 


05 
15 


06 

18 


07 
17 


II Ml Id 

88 
18 


09 
19 


0A 
1A 


OB 

1B 


iC 

1C 


00 
1D 


0E 
1E 


SF 
1F 


Row 2 


20 
30 


21 
31 


22 
32 


23 
33 


24 
34 


25 
35 


26 
38 


27 

37 


28 
38 


29 
39 


2A 
3A 


2B 
3B 


2C 
3C 


2D 
3D 


2E 
3E 


2F 
3F 


Row 3 


40 
50 


41 

51 


42 
52 


43 
53 


44 
54 


45 
55 


46 
56 


47 
57 


48 
58 


49 
59 


4A 
5A 


4B 

5B 


4C 
5C 


40 
5D 


4E 
5E 


4F 

5F 


Row 4 


88 
70 


61 
71 


82 
72 


63 
73 


84 

74 


88 
75" 


68 
78 


87 

77 


88 
78 


69 
79 


8A 
7A 


6B 

7B 


6C 
7C 


60 
7D 


8E 
7E 


8F 

7F 


Row 5 


80 
90 


81 
91 


82 

92 


83 
93 


84 
94 


85 
95 


86 

96 


87 
97 


88 
98 


89 
93 


8A 
9A 


8B 
9B 


8C 
9C 


8D 
9D 


8E 
9E 


8F 
9F 


Row 8 


A0 

B0 


A1 

B1 


A2 
B2 


A3 

B3 


A4 
B4 


A5 
B5 


A6 
B6 


A7 
B7 


A8 
B8 


A9 

B9 


AA 
BA 


AB 

BB 


AC 

BC 


AD 

BO 


AE 
BE 


AF 
BF 


Row 7 


08 
D8 


C1 

01 


C2 
D2 


C3 
D3 


C4 
D4 


CS 
D5 


ce 

D6 


C7 
D7 


C8 

D8 


C9 

D9 


CA 
DA 


CB 
DB 


cc 

DC 


CD 

DD 


CE 

DE 


CF 
DF 


Row 8 


E0 
F0 


E1 
F1 


E2 
F2 


E3 
F3 


E4 
F4 


E5 
F5 


E6 
F6 


E7 
F7 


E8 
F8 


E9 
F9 


EA 
FA 


EB 
FB 


EC 
FC 


ED 

FD 


EE 
FE 


EF 

FF 



A 5W single density disk has 1 i sectors per cylinder, two of which are reserved 
for the GAT and HIT. Since only eight directory sectors are possible, only the 
first eight positions of each HIT row are used. Other formats use more columns 
of the HIT, depending on the number of sectors per cylinder in the formatting 
scheme. 

The eight directory records for sector 2 of the directory cylinder correspond to 
assignments in HIT positions ii, 20, 40, 60, 80, Ai, Ci, and E0. On system 
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disks, the following positions are reserved for system overlays. On data disks, 
these positions (except for 0© and 01) are available to the user. 

00 — BOOT/SYS 20 — SYS6/SYS 

01 - DIR/SYS 21 — SYS7/SYS 

02 — SYS0/SYS 22 — SYS8/SYS 

03 — SYS1 /SYS 23 — SYS9/SYS 

04 — SYS2/SYS 24 — SYS10/SYS 

05 — S YS3/SYS 25 — SYS 1 1 /SYS 
©6 — SYS4/S YS 26 — SYS 1 2/SYS 
07 _ SYS5/S YS 27 — SYS 1 3/SYS 

These entry positions correspond to the first two rows of each directory sector 
for the first eight directory sectors. Since the operating system accesses these 
overlays by position in the HIT rather than by filename, these positions are 
reserved on system disks. 

The design of the Hash Index Table limits the number of files on any one drive 
to a maximum of 256. 



Locating a Directory Record 



Because of the coding scheme used on the entries in the HIT table, you can 
locate a directory record with only a few instructions. The instructions are: 



AND 1FH 

ADD A>2 

and 

AND S3E0H 



(calculates the sector) 



(calculates the offset in that sector) 



For example, if you have a Directory Entry Code (DEC) of X'84',the following 
occurs when these instructions are performed: 

Value of accumulator 
A = X'84' 

AND 1FH 

A = X'04' 

ADD A>2 

A = X'06' 

The record is in the seventh 

sector of the directory cylinder 

(0-6) 

Using the Directory Entry Code (DEC) again, you can find the offset into the 
sector that was found using the above instructions by executing one 
instruction: 

Value of accumulator 
A = X'84' 
AND 0E0H 

A = X'80' 

The directory record is X'80' (128) 
bytes from the beginning of 
the sector 

If the record containing the sector is loaded on a 256-byte boundary (LSB of the 
address is X'00') and HL points to the starting address of the sector, then you 
can use the above value to calculate the actual address of the directory record 
by executing the instruction: 

LD L >A 
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When executed after the calculation of the offset, this causes HL to point to the 
record. For example; 

A = X'80' 

LD H L > 4 2 H ; Where sector is loaded 
LD L , A .-Replace LSB with offset 

HL now contains 4280H, which is the address of the directory record you 
wanted. 

If you cannot place the sector on a 256-byte boundary, then you can use the 
following instructions: 

A = X'80' 

.Where sector is loaded 
;Put offset in E (LSB) 

;Put a zero in D (MSB) 
;Add two values together 

HL now contains 42D6H, which is the address of the directory record. 

Note that the first DEC found with a matching hash code may be the file's 
extended directory entry (FXDE). Therefore, if you are going to write system 
code to deal with this directory scheme, you must properly deal with the FPDE/ 
FXDE entries. See Directory Records for more information. 



LD 


HL»42 


LD 


E»A 


LD 


D>0 


ADD 


HL»DE 
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Programming With Restart Vectors 



The Restart instruction (RST) provides the assembly language programmer 
with the ability to call a subroutine with a one-byte call. If a routine is called 
many times by a program, the amount of space that is saved by using the RST 
instruction (instead of a three-byte CALL) can be significant. 

In TRSDOS a RST instruction is also used to interface to the operating system. 
The system uses RST 28H for supervisor calls. RSTS 00H, 30H, and 38H are 
for the system's internal use. 

RSTs 08H, 10H, 18H, and 20H are available for your use. Caution: Some pro- 
grams, such as BASIC, may use some of these RSTs. 

Each RST instruction calls the address given in the operand field of the instruc- 
tion. For example, RST 18H causes the system to push the current program 
counter address onto the stack and then set the program counter to address 
0018H. RST 20H causes a jump to location 0020H, and so on. 

Each RST has three bytes reserved for the subroutine to use. If the subroutine 
will not fit in three bytes, then you should code a jump instruction (JP) to where 
the subroutine is located. At the end of the subroutine, code a return instruction 
(RET). Control is then transferred to the instruction that follows the RST 

For example, suppose you want to use RST 18H to call a subroutine named 
"ROUTINE!' The following routine loads the restart vector with a jump instruc- 
tion and saves the old contents of the restart vector for later use. 



SETRST: 



LOOP: 



RDATA: 



LD 
LD 
LD 
LD 

LD 

LD 

LD 

INC 

INC 

DJNZ 
RET 
DEFB 
DEFW 



IX»0018H 
IY »RDATA 
B ,3 
A t ( I X ) 

C » ( IY > 

(IK) >C 

( IY) »A 

IX 

IY 

LOOP 

0C3H 
ROUTINE 



Res 
Dat 
Nun) 
Rea 
res 
Rea 
a re 
Sto 
res 
Sto 
are 
Inc 
po i 
Inc 
po i 
Loo 
Ret 
J urn 
Ope 
sub 



tart area address 

a area address 

ber of bvtes to wo ye 

d a byte from 

tart area 

d a byte f r o m data 

a 

re this byte in 

tart area 

re this byte in data 

a 

rement restart area 

nte r 

r e w e n t data area 

nt e r 

p till 3 bytes moved 

urn when done 

p instruction ( J P ) 

rand (name of 

routine) 



Before exiting the program, calling the above routine again puts the original 
contents of the restart vector back in place. 



KFLAG$ (BREAK) . (PAUSE) , and CENTER) 

Interfacing 



KFLAG$ conta ins three bits associated with the keyboard functions of BREAK, 
PAUSE ( (SHIFT) ©), and ENTER. A task processor interrupt routine (called the 
KFLAG$ scanner) examines the physical keyboard and sets the appropriate 
KFLAG$ bit if any of the conditions are observed. Similarly, the RS-232C driver 
routine also sets the KFLAG$ bits if it detects the matching conditions being 
received. 
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Many applications need to detect a PAUSE or BREAK while they are running. 
BASIC checks for these conditions after each logical statement is executed 
(that is, at the end of a line or at a ":"). That is how, in BASIC, you can stop a 
program with the (BRIM) key or pause a listing. 

One method of detecting the condition in previous TRSDOS operating systems 
was to issue the @KBD supervisor call to check for BREAK or PAUSE 
( (SHIFT) (@)), ignoring all other keys. Unfortunately, this caused keyboard type- 
ahead to be ineffective; the @KBD SVC flushed out the type-ahead buffer if 
any other keystrokes were stacked up. 

Another method was to scan the keyboard, physically examining the keyboard 
matrix. An undesirable side effect of this method was that type-ahead stored up 
the keyboard depression for some future unexpected input request. Examining 
the keyboard directly also inhibits remote terminals from passing the BREAK or 
PAUSE condition. 

In TRSDOS Version 6, the KFLAG$ scanner examines the keyboard for the 
BREAK, PAUSE, and ENTER functions. If any of these conditions are detected, 
appropriate bits in the KFLAG$ are set (bits 0, 1, and 2 respectively). 

Note that the KFLAG$ scanner only sets the bits. It does not reset them 
because the "events" would occur too fast for your program to detect. Think of 
the KFLAG$ bits as a latch. Once a condition is detected (latched), it remains 
latched until something examines the latch and resets it — a function to be per- 
formed by your KFLAG$ detection routine. 

Under Version 6.2, you can use the @CKBRKC SVC, SVC 106, to see if the 
BREAK key has been pressed. If a BREAK condition exists, (SCKBRKC resets 
the break bit of KFLAG$. 

For illustration, the following example routine uses the BREAK and PAUSE 
conditions: 



KFLAG* EQU 10 

iFLAGS EQU 101 

@KBD EQU 8 

@KEY EQU 1 

0PAUSE EQU IB 

CKPAWS LD A»@FLAGS 

RST 28H 

LD A ,(IY+KFLAG$) 

RRCA 

JP CtGOTBRK 

RRCA 

RET NC 

CALL RESKFL 

PUSH DE 

FLUSH LD A»@KBD 

RST 2SH 

JR Z»FLUSH 

POP DE 

PROMPT PUSH DE 

LD A»@KEY 

RST 28H 

POP DE 

CP 80H 

JP Z»GOTBRK 

CP G0H 

JR Z»PROMPT 

RESKFL PUSH HL 

PUSH AF 

LD A»@FLAGS 

RST 28H 

RESKFL1 LD A , ( IY + KFLAG* ) 

AND 0F8H 



5 G e t F 1 a 3 s pointer 
Hivito register I Y 
iGet the KFLAG$ 
jBit to carry 
5Go on BREAK 
iBit 1 to carry 
i Re turn if no pause 
SReset the flaS 

iFlush type-ahead 
5 b u f f e r while 
lienor in? errors 



! k a i t on Key e n t r y 



i A b o r t on (HEAR) 

ilsnore PAUSE? 
5e 1 se . . . 
5 reset KFLAG* 

SGet flaSs pointer 
I i n t o register I Y 
iGet the f 1 a <r 
JStrip ENTER* 
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KFLAG$ 


EOU 


10 


CKPAWS 


LD 


A >@FLAGS 




RST 


2SH 




LD 


A»(IY+KFLAG$) 




RRCA 






JP 


C> GOTBRK 




RRCA 






RET 


NC 



LD (IY+KFLAG*) »A 5PAUSE, BREAK 

PUSH BC 

LD B»1G 

LD A»@PAUSE iPause a while 

RST 2SH 

POP BC 

LD A»UY+KFLAG$) iChecK if finder is 

AND 3 istill on Key 

JR NZ»RESKFL1 iReset it asain 

POP AF iRestore registers 

POP HL iand exit 

RET 

The best way to explain this KFLAG$ detection routine is to take it apart and 
discuss each subroutine. The first piece reads the KFI_AG$ contents: 

! G e t F 1 a 3 s pointer 
5 i n t o register I Y 
.Get the KFLAG$ 
.Bit to carry 
jGo on BREAK 
.Bit 1 to carry 
.Return if no pause 

The ©FLAGS SVC obtains the flags pointer from TRSDOS. Note that if your 
application uses the IY index register, you should save and restore it within the 
CKPAWS routine. (Alternatively, you could use @FLAGS to calculate the loca- 
tion of KFLAG$, use register HL instead of IY, and place the address into the LD 
instructions of CKPAWS at the beginning of your application.) 

The first rotate instruction places the BREAK bit into the carry flag. Thus, if a 
BREAK condition is in effect, the subroutine branches to "GOTBRK," which is 
your BREAK handling routine. 

If there is no BREAK condition, the second rotate places what was originally in 
the PAUSE bit into the carry flag. If no PAUSE condition is in effect, the routine 
returns to the caller. 

This sequence of code gives a higher priority to BREAK (that is, if both BREAK 
and PAUSE conditions are pending, the BREAK condition has precedence). 
Note that the GOTBRK routine needs to clear the KFLAG$ bits after it services 
the BREAK condition. This is easily done via a call to RESKFL. 

The next part of the routine is executed on a PAUSE condition: 

iReset the flaS 

FLUSH LD A»@KBD iFlush type-ahead 

ibuffer while 
ii^nor in 3 errors 

First the KFLAG$ bits are reset via the call to RESKFL. Next, the routine takes 
care of the possibility that type-ahead is active. If it is, the PAUSE key was prob- 
ably detected by the type-ahead routine and so is stacked in the type-ahead 
buffer also. To flush out (remove all stored characters from) the type-ahead 
buffer, @KBD is called until no characters remain (an NZ is returned). 

Now that a PAUSEd state exists and the type-ahead buffer is cleared, the rou- 
tine waits for a key input: 



CALL 


RESKFL 


PUSH 


DE 


LD 


A»@KBD 


RST 


2SH 


JR 


Z»FLUSH 


POP 


DE 



PROMPT PUSH DE 



LD 


A»@KEY 


RST 


2SH 


POP 


DE 


CP 


S0H 


JP 


Z» GOTBRK 



! W a i t on Key entry 



iAbort on (ffiffi) 
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CP 
JR 



BOH 

Z tPROMPT 



! I Sno re 
!e 1 se . 



pause; 



The PROMPT routine accepts a BREAK and branches to your BREAK han- 
dling routine. It ignores repeated PAUSE (the 60H). Any other character causes 
it to fall through to the following routine which clears the KFLAG$: 



RESKFL PUSH HL 

PUSH AF 

LD A»§FLAGS 

RST 28H 

RESKFL1 LD A , ( I Y+KFLAG$ ) 

AND 0F8H 

LD (IY+KFLAG*) »A 

PUSH BC 

LD BtlG 

LD A»§PAUSE 

RST 28H 

POP BC 

LD A »( IY+KFLAG*) 

AND 3 

JR NZ»RESKFL1 

POP AF 

POP HL 

RET 



! reset KFLAG* 

!Get f 1 a sf s pointer 
jinto register I Y 
!Get the flaS 
SStrip ENTER* 
5PAUSE, BREAK 



jPause a while 



jChecK if finder is 
! s t i 1 1 on Key 
jReset it a 3 a i n 
jResto re registers 
! and exit 



The RESKFL subroutine should be called when you first enter your application. 
This is necessary to clear the flag bits that were probably in a "set" condition. 
This "primes" the detection. The routine should also be called once a BREAK, 
PAUSE, or ENTER condition is detected and handled. (You need to deal with 
the flag bits for only the conditions you are using.) 



Interfacing to @ICNFG 



With the TRSDOS library command SYSGEN, many users may wish to SYS- 
GEN the RS-232C driver. Before doing that, the RS-232C hardware (UART, 
Baud Rate Generator, etc.) must be initialized. Simply using the SYSGEN com- 
mand with the RS-232C driver resident is not enough; some initialization 
routine is necessary. The @ICNFG (Initialization CoNFiGuration) vector is 
included in TRSDOS to provide a way to invoke a routine to initialize the RS- 
232C driver when the system is booted. It also provides a way to initialize the 
hard disk controller at power-up (required by the Radio Shack hard disk 
system). 

The final stages of the booting process loads the configuration file CONFIG/ 
SYS if it exists. After the configuration file is loaded, an initialization subroutine 
CALLs the @ICNFG vector. Thus, any initialization routine that is part of a 
memory configuration can be invoked by chaining into @ICNFG. 

If you need to configure your own routine that requires initialization at power-up, 
you can chain into @ICNFG. The following procedure illustrates this link. The 
first thing to do is to move the contents of the @ICNFG vector into your initiali- 
zation routine: 

j G e t f 1 a 3 s pointer 
jinto register I Y 
!Ge t opcode 

!Get address LOW 
iGet address HIGH 

This subroutine does this by transferring the 3-byte vector to your routine. You 
then need to relocate your routine to its execution memory address. Once this 



LD 


A»§FLAGS 


RST 


28H 


LD 


A t<IY+28) 


LD 


(LINK) »A 


LD 


L t(IY+29) 


LD 


H t(IY+30) 


LD 


(LINK+1) »HL 
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is done, transfer the relocated initialization entry point to the @ICNFG vector as 
a jump instruction: 

LD HL.INIT iGet (relocated) 

LD <IY+29)jL iinit address 

LD <IY + 30) ,H 

LD A»0C3H !Set JP instruction 

LD (IY+28) tf\ 

If you need to invoke the initialization routine at this point, then you can use: 

CALL ROUTINE ilnuoke your routine 

Your initialization routine would be unique to the function it was to perform, but 
an overall design would look like this: 

iStart of init 
iContinue on 

your initialization routine 

RET 

After linking in your routine, perform the SYSGEN. If you have followed these 
procedures, your routine will be invoked every time you start up TRSDOS. 



INIT 


CALL 


ROUTINE 


LINK- 


DEFS 


3 


ROUTINE 







Interfacing to @KITSK 



Background tasks can be invoked in one of two ways. For tasks that do not 
require disk I/O, you can use the RTC (Real Time Clock) interrupt and one of 
the 12 task slots (or other external interrupt). For tasks that require disk I/O, you 
can use the keyboard task process. 

At the beginning of the TRSDOS keyboard driver is a call to @KITSK. This 
means that any time that @KBD is called, the @KITSK vector is also called. 
(The type-ahead task, however, bypasses this entry so that @KITSK is not 
called from the type-ahead routine.) Therefore, if you want to interface a back- 
ground routine that does disk I/O, you must chain into @KITSK. 

The interfacing procedure to @KITSK is identical to that shown in the section 
"Interfacing to @ICNFG," except that IY + 31 through IY + 33 is used to refer- 
ence the @KITSK vector. You may want to start your background routine with: 

START CALL ROUTINE ilnuoKe tasK 
LINK DEFS 3 !For 0KITSK hooK 

ROUTINE EOU $ iStart of the task 

Be aware of one major pitfall. The @KBD routine is invoked from @CMNDI and 
@CMNDR (which is in SYS1/SYS). This invocation is from the @KEYIN call, 
which fetches the next command line after issuing the "TRSDOS Ready" mes- 
sage. If your background task executes and opens or closes a file (or does any- 
thing to cause the execution of a system overlay other than SYS1 ), then SYS1 
is overwritten by SYS2 or SYS3. When your routine finishes, the @KEYIN han- 
dler tries to return to what called it — SYS1, which is no longer resident. There- 
fore, any task chained to @KITSK which causes a resident SYS1 to be over- 
written must reload SYS1 before returning. 

You can use the following code to reload SYS1 if SYS1 was resident prior to 
your task's execution: 

iGet f la3s pointer 
jinto register IY 
!Get resident o v e r - 
5 lay and remove 
jthe entry code 
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ROUTINE LD 


A .0FLAGS 


RST 


28H 


LD 


Af (IY-1) 


AND 


8FH 


LD 


(OLDSYS+1) fA 



rest of your task 



EXIT 


EOU 


$ 


OLDSYS 


LD 


A»0 




CP 


83H 




RET 


NZ 




RST 


28H 



5Get old overlay * 
JWas it SYS1? 
5 Return if not? else 
5Get SYS1 per re<f, A 
5 ( no RET needed ) 



Interfacing to the Task Processor 



This section explains how to integrate interrupt tasks into your applications. 

One of the hardware interrupts in the TRS-80 is the real time clock (RTC). The 
RTC is synchronized to the AC line frequency and pulses at 60 pulses per sec- 
ond, or once every 16.67 milliseconds. (Computers operating with 50 Hz AC 
use a 50 pulses per second RTC interrupt. In this case, all time relationships 
discussed in this section should be adjusted to the 50 Hz base.) 

A software task processor manages the RTC interrupt in performing back- 
ground tasks necessary to specific functions of TRSDOS (such as the time 
clock, blinking cursor, and so on). The task processor allows up to 12 individual 
tasks to be performed on a "time-sharing" basis. 

These tasks are assigned to "task slots" numbered from to 11. Slots 0-7 are 
considered "low priority" tasks (executing every 266.67 milliseconds). Slots 8- 
10 are medium priority tasks (executing every 33.33 milliseconds). Slot 11 is a 
high priority task (executing every 16.66 milliseconds SYSTEM (FAST) or 33.33 
milliseconds SYSTEM (SLOW)). Task slots 3, 7, 9, and 10 are reserved by the 
system for the ALIVE, TRACE, SPOOL, and TYPE-AHEAD functions, 
respectively. 

TRSDOS maintains a Task Control Block Vector Table (TCBVT) which contains 
12 vectors, one for each of the 12 task slots. TRSDOS contains five supervisor 
calls that manage the task vectors. The five SVCs and their functions are: 

@CKTSK Checks to see whether a task slot is unused or active 

@ADTSK Adds a task to the TCBVT 

@RMTSK Removes a task from the TCBVT 

@KLTSK Removes the currently executing task 

@RPTSK Replaces the TCB address for the current task 

The TRSDOS Task Control Block Vector Table contains vector pointers. Each 
TCBVT vector points to an address in memory, which in turn contains the 
address of the task. Thus, the tasks themselves are indirectly addressed. 

When you are programming a task to be called by the task processor, the entry 
point of the routine needs to be stored in memory. If you make this storage loca- 
tion the beginning of a Task Control Block (TCB), the reason for indirect vector- 
ing of interrupt tasks will become more clear. Consider an example TCB: 

MYTCB DEFW MYTASK 

COUNTER DEFB 15 

TEMPY DEFS 1 

MYTASK RET 

This is a useless task, since the only thing it does is return from the interrupt. 
However, note that a TCB location has been defined as "MYTCB" and that this 
location contains the address of the task. A few more data bytes immediately 
following the task address storage have also been defined. 

Upon entry to a service routine, index register IX contains the address of the 
TCB. You can therefore address any TCB data using index instructions. For 
example, you could use the instruction "DEC (IX + 2)" to decrement the value 
contained in COUNTER in the above routine. 
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8 Using the Supervisor Calls 



Supervisor Calls (SVCs) are operating system routines that are available to 
assembly language programs. These routines alter certain system functions 
and conditions, provide file access, and perform various computations. They 
also perform I/O to the keyboard, video display, and printer. 

Each SVC has a number which you specify to invoke it. These numbers range 
from© to 104. 



In addition, under Version 6.2, you can write your own operating system rou- 
tines using the numbers 124 through 127 to install your own SVCs. See Ap- 
pendix E, "Programmable SVCs" for more information. 



Calling Procedure 



TocallaTRSDOSSVC: 

1 . Load the SVC number for the desired SVC into register A. Also load any 
other registers which are needed by the SVC, as detailed under Supervisor 
Calls. 

2. Execute a RST 28H instruction. 

Note: If the SVC number supplied in register A is invalid, the system prints the 
message "System Error xx", where xx is usually 2B. It then returns you to 
TRSDOS Ready (not to the program that made the invalid SVC call). 

The alternate register set (AF,' BC,' DE,' HL') is not used by the operating system. 



Program Entry and Return Conditions 



When a program executed from the @CMNDI SVC is entered, the system 
return address is placed on the top of the stack. Register HLwili point to the first 
non-blank character following the command name. Register BC will point to the 
first byte of the command line buffer. 

Three methods of return from a program back to the system are available: the 
©ABORT SVC, the @EXIT SVC, and the RET instruction. For application pro- 
grams and utilities, the normal return method is the @EXIT SVC. If no error con- 
dition is to be passed back,- the HL register pair must contain a zero value. Any 
non-zero value in HL causes an active JCL to abort. 

The @ABORT SVC can be used as an error return back to the system; it auto- 
matically aborts any active JCL processing. This is done by loading the value 
X'FFFF' into the HL register pair and internally executing an @EXIT SVC. 

If stack integrity is maintained, a RET instruction can be used since the system 
return address is put on the stack by @CMNDI. This allows a return if the pro- 
gram was called with @CMNDR. 

Most of the SVCs in TRSDOS Version 6 set the Z flag when the operation spec- 
ified was successful. When an operation fails or encounters an error, the Z flag 
is reset (also known as NZ flag set) and a TRSDOS error code is placed in the 
A register. The remaining SVCs use the Z/NZ flag in differing ways, so you 
should refer to the description of the SVCs you are using to determine the exit 
conditions. 
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Supervisor Calls 



The TRSDOS Supervisor Calls are: 



Keyboard SVCs 


Byte I/O SVCs 


@KBD 


©CTL 


@KEY 


©GET 


@KEYIN 


©PUT 


Printer and Video SVCs 


File Control SVCs 


@DSP 


©CLOSE 


@DSPLY 


©FEXT 


@LOGER 


©FNAME 


@LOGOT 


©FSPEC 


@MSG 


©INIT 


@PRT 


©REMOV 


(SPRINT 


©OPEN 


@VDCTL 


©RENAM 


Disk SVCs 


Disk File Handler SVCs 


©DCINIT 


©BKSP 


@DCRES 


©CKEOF 


©DCSTAT 


©LOC 


@RDSEC 


©LOF 


@RDSSC 


©PEOF 


@RSLCT 


©POSN 


@RSTOR 


©READ 


©SEEK 


©REW 


@SLCT 


©RREAD 


@STEPI 


©RWRIT 


@VRSEC 


©SEEKSC 


@WRSEC 


©SKIP 


@WRSSC 


©VER 


@WRTRK 


©WEOF 




©WRITE 


System Control SVCs 


TRSDOS Task Control SVCs 


©ABORT 


©ADTSK 


©BREAK 


©CKTSK 


©CMNDI 


©KLTSK 


©CMNDR 


©RMTSK 


©EXIT 


©RPTSK 


©FLAGS 




@HIGH$ 




©IPL 




©LOAD 




©RUN 




Special Purpose Disk SVCs 


Special Overlay SVCs 


©DIRRD 


©CKDRV 


©DIRWR 


©DEBUG 


©GTDCT 


©DODIR 


©HDFMT 


©ERROR 


©RDHDR 


©PARAM 


©RDTRK 


©RAMDIR 
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CKBRKC SVC Number 106 

Check BREAK bit and clear it Version 6.2 only 

Checks to see if the BREAK key has been pressed. If a BREAK condition exists, 
@CKBRKC resets the break bit, Bit of KFLAG$. 

Entry Conditions: 

A=106(X'6A') 

Exit Conditions: 

Success always. 

If Z flag is set, the break bit was not detected. If NZ flag is set, the 
break bit was detected and is cleared. If the BREAK key is being de- 
pressed, the SVC will not return until the key is released. 

General: 

Only AF is altered by this SVC. 



236.1 



236.2 - "intentionally blank" 



CKDRV 



SVC Number 33 



Check Drive 



Checks a drive reference to ensure that the drive is in the system and a 
TRSDOS Version 6 or LDOS 5.1.3 (Model III Hard Disk Operating System) for- 
matted disk is in place. 

Entry Conditions: 

A=33(X'2f) 

C= logical drive number (0-7) 

Exit Conditions: 

Success always. 

If Z flag is set, the drive is ready. 

If CF is set, the disk is write protected. 
If NZ flag is set, the drive is not ready. The user may examine DCT + 
to see if the drive is disabled. 

Example: 

See Sample Program D, lines 35-55. 
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CKEOF SVC Number 62 



Check for End-Of-File 



Checks for the end of file at the current logical record number. 

Entry Conditions: 

A = 62(X3E') 

DE = pointer to the FCB of the file to check 

Exit Conditions: 

Success always. 

If Z flag is set, LOC does not point at the end of file (LOC < LOF). 
If NZ flag is set, test A for error number: 

If A = X'1C,' LOC points at the end of the file (LOC = LOF). 

If A = X'1 D,' LOC points beyond the end of the file (LOC > LOF). 

If A =/= X' 1 C or X' 1 D,' then A = error number. 

General: 

Only AF is altered by this SVC. 

Example: 

See Sample Program C, lines 352-353. 
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CKTSK SVC Number 28 



Check if Task Slot in Use 



Checks to see if the specified task slot is in use. 

Entry Conditions: 

A = 28(X'1C) 

C = task slot to check (0-1 1 ) 

Exit Conditions: 

Success always. 

If Z flag is set, the task slot is available for use. 
If NZ flag is set, the task slot is already in use. 

General: 

AF and HL are altered by this SVC. 

Example: 

See Sample Program F, lines 70-73. 
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CLOSE SVC Number 60 



Close a File or Device 



Terminates output to a file or device. Any unsaved data in the buffer area is 
saved to disk and the directory is updated. All files that have been written to 
must be closed, as well as all files opened with UPDATE or higher access. 

If you remove a diskette containing an open file, any attempt to close the file 
results in the message: 

** CLOSE FAULT ** error message, <ENTER> to retry, <BREAK> to 
abort 

where error message is usually "Drive not ready". You may put the diskette 
back in the drive and: 



1 . Press (ENTER) to close the file. 

2. Press (BREAK) to abort the close. 

If you press fBREAKl . the NZ flag is set and Register A contains X'20\ the error 
code for an Illegal drive number error. 

Entry Conditions: 

A =60(X'3C) 

DE = pointer to FCB or DCB to close 

Exit Conditions: 

Success, Z flag set. The file or device was closed. The filespec (excluding 

the password) or the devspec is returned to the FCB or DCB. 
Failure, NZ flag set. 
A= error number 

General: 

Only AF is altered by this SVC. 

Example: 

See Sample Program C, lines 360-368. 
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CLS SVC Number 105 

Clear Video Screen Version 6.2 only 

Clears the video screen by sending a Home Cursor (X'1 C) and Clear to End of 
Frame (X'1 F') sequence to the video driver. 

Entry Conditions: 

A = 105(X'69') 

Exit Conditions: 

Success, Z flag is set. 
Failure, NZ is set. 

A = error number 

General: 

Only AF is altered by this SVC. 



240.1 



240.2 - "intentionally blank" 



CTL 



SVC Number 5 



Output a Control Byte 



Outputs a control byte to a logical device. The DCB TYPE byte (DCB + 0, Bit 2) 
must permit CTL operation. See the section "@CTL Interfacing to Device Driv- 
ers" for information on which of the functions listed below are supported by the 
system device drivers. 

Entry Conditions: 

A =5(X'05') 

DE = pointer to DCB to control output 

C selects one of the following functions: 

If C = 0, the status of the specified device will be returned. 

If C = 1, the driver is requested to send a BREAK or force an interrupt. 

If C = 2, the initialization code of the driver is to be executed. 

If C = 3, all buffers in the driver are to be reset. This causes all pending 

I/O to be cleared. 
If C = 4, the wakeup vector for an interrupt-driven driver is specified by 
the caller. 

IY = address to vector when leaving driver. If IY = 0, then 

the wakeup vector function is disabled. The RS-232C 

driver COM/DVR ($CL), is the only system driver that 

provides wakeup vectoring. 

If C = 8, the next character to be read will be returned. This allows data 

to be "previewed" before the actual @GET returns the character. 

Exit Conditions: 
If C = 0, 

Z flag set, device is ready 
NZ flag set, device is busy 

A = status image, if applicable 
Note: This is a hardware dependent image. 
Iff C = 1. 

Success, Z flag set. BREAK or interrupt generated. 
Failure, NZ flag set 

A = error number 
lfC = 2, 

Success, Z flag set. Driver initialized. 
Failure, NZ flag set 

A = error number 
If C = 3, 

Success, Z flag set. Buffers cleared. 
Failure, NZ flag set. 

A = error number 
If C = 4, 

Success always. 

IY = previous vector address 
This function is ignored if the driver does not support wakeup 
vectoring. 
If C = 8, 

Success, Z flag set. Next character returned. 

A = next character in buffer 
Failure, NZ flag set. Test register A: 

If A= 0, no pending character is in buffer 

If A^0, A contains error number. (TRSDOS driver returns Error 43.) 
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General: 

BC, DE, HL, and IX are saved. 

Function codes 5 to 7, 9 to 31, and 255 are reserved for the system. Function codes 
32 to 254 are available for user definition. 

Entry and exit conditions for user-defined functions are up to the design of the user- 
supplied driver. 

Example: 

See the section "Device Driver and Filter Templates." 
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ERROR SVC Number 26 

Entry to Post an Error Message 

Provides an entry to post an error message. If bit 7 of register C is set, the error 
message is displayed and return is made to the calling program. If bit 6 is not 
set, the extended error message is displayed. Under versions prior to 6.2 the 
error display is in the following format: 

*** Errcod=xx> Error message strinS *** 

<filespec or devspec) 
Referenced at X'dddd' 

Under Version 6.2 the error display is in the following format: 

*# Error code = xx > Returns to X" dddd ' 

** Error message strinS 

< f i 1 espec t devspec t or open FCB/DCB s t a t us> 

Last SMC = linn t Returned to X" r r r r' 

dddd is the return address of the ©ERROR SVC in the application program. 

nnn is the last SVC executed before the ©ERROR SVC request. 

rrrr is the address the previous SVC returned to in the application program. 

If bit 6 is set, then only the "Error message string" is displayed. This bit is 
ignored if bit 6 of SFLAG$ (the extended error message bit) is set. If bit 6 of 
CFLAG$ is set, then no error message is displayed. If bit 7 of CFLAG$ is set, 
then the "Error message string" is placed in a user buffer pointed to by register 
pair DE. See @FLAGS (SVC 101) for more information on SFLAG$ and 
CFLAG$. 

Entry Conditions: 

A = 26(X'1A) 

C = error number with bits 6 and 7 optionally set 

Exit Conditions: 

Success always. 

General: 

To avoid a looping condition that could result from the display device gen- 
erating an error, do not check for errors after returning from @ERROR. 

If you do not set bit 6 of register C, then you should execute this SVC only 
after an error has actually occurred. 

Example: 

See Sample Program C, lines 379-389. 
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EXIT SVC Number 22 



Exit to TRSDOS 



This is the normal program exit and return to TRSDOS. An error exit can be 
done by placing a non-zero value in HL. Values 1 to 62 indicate a primary error 
as described in TRSDOS Error Codes (Appendix A). (A non-zero value in HL 
causes an active JCL to abort.) 

Entry Conditions: 

A =22(X'16') 
HL = Return Code 

If HL = 0, then no error on exit. 

If HL 4> 0, then the ©ABORT SVC returns X'FFFF in HL automatically. 

General: 

This SVC does not return. 

Example: 

See Sample Program B, lines 206-207. 
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FEXT SVC Number 79 

Set Up Default File Extension 

Inserts a default file extension into the File Control Block if the file specification 
entered contains no extension. @FEXT must be done before the file is opened. 

Entry Conditions: 

A =79(X'4F) 
DE = pointer to FCB 

HL=pointer to default extension (3 characters; alphabetic characters 
must be upper case and first character must be a letter) 

Exit Conditions: 

Success always. 

AF and BC are altered by this SVC. 

If the default extension is used, HL is also altered. 

Example: 

See Sample Program C, lines 111-132. 



261 



FLAGS SVC Number 101 



Point IY to System Flag Table 



Points the IY register to the base of the system flag table. The status flags listed 
below can be referenced off IY You can alter those bits marked with an asterisk 
(*). Bits without an asterisk are indicators of current conditions, or are unused 
or reserved. 

Note: You may wish to save KFLAG$ and SFLAG$ if you intend to modify them 
in your program, and restore them on exit. 

Entry Conditions: 

A=101 (X'65') 

Exit Conditions: 

Success always. 

IY= pointer to the following system information: 

IY - 1 Contains the overlay request number of the last system module 
resident in the system overlay region. 

IY + = AFLAG$ (allocation flag under Version 6.2 only) 

Contains the starting cylinder number to be used when 
searching for free space on a diskette. It is normally 1 . 
If the starting cylinder number is larger than the number 
of cylinders for a particular drive, 1 is used for that drive. 

IY + 2 =CFLAG$ 

* bit 7 — If set, then ©ERROR will transfer the "Error message 

string" to your buffer instead of displaying it. The mes- 
sage is terminated with X'0D.' 

* bit 6 — If set, do not display system error messages 0-62. See 

©ERROR (SVC 26) for more information. 

* bit 5 — If set, sysgen is not allowed. 

* bit 4 — If set, then ©CMNDR will execute only system library 

commands, 
bit 3 — If set, @RUN is requested from either the SET or 

SYSTEM (DRIVER = ) commands, 
bit 2 — If set, @KEYIN is executing due to a request from 

SYS1. 
bit 1 _ |f set, @CMNDR is executing. This bit is reset by 

©EXIT and @CMNDI. 

* bit — If set, HIGH$ cannot be changed using @HIGH$ 

(SVC 100). This bit is reset by ©EXIT and ©CMNDI. 

IY + 3 =DFLAG$ (device flag) 

* bit 7 — "1" if GRAPHIC printer capability desired on screen 

print ( (CONTROL) CD causes screen print. See the SYS- 
TEM (GRAPHIC) command under "Technical Infor- 
mation on TRSDOS Commands and Utilities.") 

bit 6 — "1" if KSM module is resident 

bit 5 — Currently unused 

bit 4 — "1" if MemDisk active 

bit 3 — Reserved 

bit 2 — "1" if Disk Verify is enabled 

* bit 1 — "1" if TYPE-AHEAD is active 
bit — "1" if SPOOL is active 

IY + 4 = EFLAG$ (ECI flag under Version 6.2 only) 

Indicates the presence of an ECI program. If any of the 
bits are set, an ECI is used, rather than the SYS1 inter- 
preter. The ECI program may use these bits as necce- 
sary. However, at least one bit must be set or the ECI is 
not executed. 
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IY + 5 =FEMSK$ (mask for port 0FEH) 
IY + 8 =IFLAG$ (international flag) 

* bit 7 — If "1," 7-bit printer filter is active 

If "0," normal 8-bit filters are present 

* bit 6 — If "1," international character translation will be per- 

formed by printer driver 

If "0," characters received by printer driver will be sent 

to the printer unchanged 
bit 5 — Reserved for future languages 
bit 4 — Reserved for future languages 
bit 3 — Reserved for future languages 
bit 2 — Reserved for future languages 
bit 1 — If "1," German version of TRSDOS is present 
bit — If "1? French version of TRSDOS is present 
If bits 5-0 are all zero, then USA version of TRSDOS is present. 
I Y + 1 = KFLAG$ (keyboard flag) 

bit 7 — "1" if a character is present in the type-ahead buffer 
bit 6 — Currently unused 

* bit 5 — "1" if CAPS lock is set 
bit 4 — Currently unused 

bit 3 — Curre ntly un used 

* bit 2 — "1" if (ENTER) has been pressed 

* bit 1 — "1" if (SHIFT) © has been pressed (PAUSE) 

* bit — "1" if (BREAK) has been pressed 

Note: To use bits 0-2, you must first reset them and then test to 

see if they become set. 
IY + 1 2 = MODOUT (image of port 0ECH) 
IY+ 13= NFLAG$ (network flag under Version 6.2) 

bit 7 — Reserved for system use. 

bit 6 — If set, the application program is in the task processor. 
Programmers must not modify this bit. 

bit 5 — Reserved for system use. 

bit 4 — Reserved for system use. 

bit 3 — Reserved for system use. 

bit 2 — Reserved for system use. 

bit 1 — Reserved for system use. 

* bit — If set, the "file open bit" is written to the directory. 
IY+ 14=0PREG$ (memory management & video control image) 
IY+ 1 7= RFLAG$ (retry flag under Version 6.2 only) 

Indicates the number of retrys for the floppy disk driver. 
This should be an even number larger than two. 
I Y + 1 8 = SFLAG$ (system flag) 

bit 7 — "1" if DEBUG is to be turned on 

* bit 6 — "1" if extended error messages desired (see 

@ERROR for message format); overrides the setting 
of bit 6 of register C on ©ERROR (SVC 26) and 
should be used only when testing 
bit 5 — "1" if DO commands are being executed 

* bit 4 — "1" if BREAK disabled 

bit 3 — "1" if the hardware is running at 4 mhz (SYSTEM 
(FAST)). If "0," the hardware is running at 2 mhz (SYS- 
TEM (SLOW)). 

* bit 2 — "1" if LOAD called from RUN 

* bit 1 — "1" if running an EXECute only file 

* bit — "1" specifies no check for matching LRL on file open 

and do not set file open bit in directory. This bit should 
be set just before executing an @OPEN (SVC 59) if 
you want to force the opened file to be READ only dur- 
ing current I/O operations. As soon as either call is 
executed, SFLAG$ bit is reset. If you want to disable 
LRL checking on another file, you must set SFLAG$ 
bit again. 
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!Y + 19 = TFLAG$ (type flag under Version 6.2 only) 

Identifies the Radio Shack hardware model. TFLAG$ 
allows programs to be aware of the hardware environ- 
ment and the character sets available for the display. 
Current assignments are: 

2 indicates Model II 

4 indicates Model 4 

5 indicates Model 4P 
12 indicates Model 12 

IY + 20= UFLAG$ (user flag under Version 6.2 only) 

May be set by application programs and is sysgened 

properly. 
IY + 21 =VFLAG$ 

bit 7 — Reserved for system use 

* bit 6 — "1" selects solid cursor, "0" selects blinking cursor 
bit 5 — Reserved for system use 

* bit 4 — "1" if real time clock is displayed on the screen 
bits 0-3 — Reserved for system use 

IY + 22 = WRINTMASK$ (mask for WRINTMASK port) 

I Y + 26 = SVCTABPTR$ (pointer to the high order byte of the SVC table 

address; low order byte = 00) 
IY + 27 = Version ID byte (60H = TRSDOS version 6.0.x.x, 

61 H = TRSDOS version 6.1. x.x, etc.) 
IY- 47 = Operating system release number. Provides a third and fourth 

character (12H = TRSDOS version x.x.1.2) 
IY + 28 
to 

IY + 30 = @ICNFG vector 
IY + 31 
to 
IY + 33 = @KITSK vector 
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FNAME SVC Number 80 



Get Filename 



Gets the filename and extension from the directory using the specified Direc- 
tory Entry Code (DEC) for the file. 

Entry Conditions: 

A = 80(X'50') 

DE= pointer to 15-byte buffer to receive filename/extension:drive, fol- 
lowed by a X'0D' as a terminator 
B = DEC of desired file 
C = logical drive number of drive containing file (0-7) 

Exit Conditions: 

Success, Z flag set. 

HL = pointer to directory entry specified by register B 
Failure, NZ flag set. 

A = error number 

HL is altered. 

General: 

AF and BC are always altered. 

If the drive does not contain a disk, this SVC may hang indefinitely waiting 

for formatted media to be placed in the drive. The programmer should 

perform a @CKDRV SVC before executing this call. 
If the Directory Entry Code is invalid, the SVC may not return or it may 

return with the Z flag set and HL pointing to a random address. Care 

should be taken to avoid using the wrong value for the DEC in this call. 

Example: 

See Sample Program C, lines 274-286. 
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264.7 - "intentionally blank" 



@VDCTL SVC Number 15 



Video Functions 



Performs various functions related to the video display. The B register is used 
to pass the function number. 

Entry Conditions: 

A=15(X'0F) 

B selects one of the following functions: 

If B = 1, return the character at the screen position specified by HL. 
H = row on the screen (0-23), where is the top row 
L = column on the screen (0-79), where is the leftmost column 

If B = 2, display the specified character at the position specified by 
HL. 
C = character to be displayed 
H = row on the screen (0-23), where is the top row 
L = column on the screen (0-79), where is the leftmost column 

If B = 3, move the cursor to the position specified by HL. This is done 
even if the cursor is not currently displayed. 
H = row on the screen (0-23), where is the top row 
L = column on the screen (0-79), where is the leftmost column 

If B = 4, return the current position of the cursor. 

If B = 5, move a 1 920-byte block of data to video memory. 
HL = pointer to 1 920-byte buffer to move to video memory 

If B = 6, move a 1 920-byte block of data from video memory to a 
buffer you supply. In 40 line by 24 character mode, there must 
be a character in each alternating byte for proper display. 
HL= pointer to 1 920-byte buffer to store copy of video memory HL 
must be in the range X'23FF' < HL < X'ECOI .' 

If B = 7, scroll protect the specified number of lines from the top of the 
screen. 
C = number of lines to scroll protect (0-7). Once set, scroll protect 
can be removed only by executing @VDCTL with B = 7 and 
C = 0, or by resetting the system. Clearing the screen with 
(SHIFTKCLEAR) erases the data in the scroll protect area, but the 
scroll protect still exists. 

If B = 8, change cursor character to specified character. If the cursor 
is currently not displayed, the character is accepted anyway 
and is used as the cursor character when it is turned back on. 
The default cursor character is an underscore (X'5F') under 
Version 6.2 and a X'B0' under previous versions. 
C= character to use as the cursor character 

If B = 9, (under Version 6.2 only) transfer 80 characters to or from 
the screen. 
If C = 0, move characters from the buffer to the screen 
If C = 1 , move characters from the screen to the buffer 
H = row on the screen 
DE = pointer to 8© byte buffer 

Note: The video RAM area in the Models 4 and 4P is 2048 bytes (2K). 
The first 1920 bytes can be displayed. The remaining bytes contain the 
type-ahead buffer and other system buffers. 
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Exit Conditions: 
If B = 1: 

Success, Z flag set. 

A = character found at the location specified by HL 

DE is altered. 
Failure, NZ flag set. 

A = error number 

If B = 2: 

Success, Z flag set. 

DE is altered. 
Failure, NZ flag set. 

A = error number 

If B = 3: 

Success, Z flag set. 

DE and HL are altered. 
Failure, NZ flag set. 

A= error number 

If B = 4: 

Success always. 

HL = row and column position of the cursor. H = row on the 
screen (0-23), where is the top row; L = column on the 
screen (0-79), where is the leftmost column. 

If B = 5: 

Success always. 

HL = pointer to the last byte moved to the video + 1 
BC and DE are altered. 

If B = 6: 

Success always. 

BC, DE, and HL are altered. 

lfB = 7: 

Success always. 

BC and DE are altered. 

If B = 8: 

Success always. 

A= previous cursor character 
DE is altered. 

If B = 9 (under Version 6.2 only): 
Success, Z flag set. 

BC, HL, DE are altered. 
Failure, NZ flag set because H is out of range. 
A= error code 43 (X'2B'). 

General: 

Functions 5, 6, and 7 do not do range checking on the entry parameters. 
If HL is not in the valid range in functions 5 and 6, the results may be 

unpredictable. 
Only function 3 (B = 3) moves the cursor. 
If C is greater than 7 in function 7, it is treated as modulo 8. 
AF and B are altered by this SVC. 

Example: 

See Sample Program F, lines 304-327 
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Sample Program B, continued 



00272 

00273 

00274 

00275 

00276 

00277 

00278 

00279 

00280 

00281 

00282 

00283 

00284 

00285 

00286 

00287 

00288 

00289 

002 90 

00291 

00292 

00293 

00294 

00295 

00296 

00297 

00298 

00299 

00300 

00301 

00302 

00303 

00304 

00305 

00306 

00307 

00308 

00309 

00310 

00311 

00312 

00313 

00314 

00315 

00316 

00317 

00318 

00319 

00320 

00321 

00322 

00323 



;These are the storage declarations. 



BUF6: 

BUF5 

BUF4: 

BUF3: 

BUF2: 

DIVRl: 

DIVDl: 

ANSI: 

REMl : 

MCANDl: 

MIER1: 

MCAND2: 

DIVD2: 

ANS2: 



DEFS 
DEFS 
DEFS 
DEFS 
DEFS 
DEFB 
DEFB 
DEFB 
DEFB 
DEFB 
DEFB 
DEFW 
DEFW 
DEFW 



4 
3 
2 












;Below are messages and prompting text used in the program. 

DEFB 13 ;Number of blanks to print after message 1 

MESS1: DEFM "Enter a number (1-255).' 

DEFB 3 ;Message-terminating character 

DEFB 21 ;Number of blanks to print after message 3 

MESS 3: DEFM 'The answer is 1 

DEFB 3 terminating character 

DEFB 18 ;Blanks after message 

MESS4: DEFM 'The remainder is 1 

DEFB 3 terminating character 

DEFB 6 ;Blanks after message 

MESS6: DEFM 'Enter a number (4369-65535).' 

DEFB 3 terminating character 

DEFB 15 ,-Blanks after message 

MESS8: DEFM 'Enter a number (1-28).' 

DEFB 3 /Terminating character 

DEFB 16 ;Blanks after message 

MESS9: DEFM 'In hex ASCII, that is' 

DEFB 3 .-Terminating character 

DEFB 17 ;Blanks after message 

MESS10: DEFM 'Enter a number (1-9).' 

DEFB 3 /Terminating character 

DEFB 11 /Blanks after message 

MESSll: DEFM 'Enter a number (1-4100).' 

DEFB 3 /Terminating character 

DEFB 15 /Blanks after message 

MESS12: DEFM 'Enter a number (1-15).' 

DEFB 3 /Terminating character 

MESS13: DEFM 'The product of those 2 numbers is ' 

DEFB 3 /Terminating character 

MESS14: DEFM 'Press <BREAK> to end or any other key to continue.' 

DEFB 0DH /Terminating character 

END START 
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Sample Program C 



Ln # 

00001 
00002 
00003 
00004 
00005 
00006 
00008 
00009 
00010 
00011 
00012 
00013 
00014 
00015 
00016 
00017 
00018 
00019 
00020 
00021 
0002 2 
0002 3 
00024 
00025 
00026 
00027 
00028 

0002 9 
00030 
00031 
00032 
00033 
00034 
00035 
00036 
00037 
00038 

0003 9 
00040 
00041 
00042 
00043 
00044 
00045 
00046 
00047 
00048 
00049 
00050 
00051 
00052 
0005 3 
0005 4 
00055 
00056 
00057 
00058 

0005 9 
00060 
00061 
00062 

0006 3 
0006 4 
00065 
0006 6 
0006 7 



Source Line 

This program prompts for two filenames, opens the first 
file, and creates the second. Then the data in the first 
file is copied to the second file. While the Copy progresses, 
the current record number is displayed in parentheses. 



PSECT 3000H 



,-This program starts at x'3000' 



First, declare the equates for the SVCs we intend to use. 

This is not mandatory, but it makes the program easier to follow. 



iCLOSE: 

6DIRRD: 

@DSP: 

iDSPLY: 

§ ERROR: 

8EXIT: 

iFEXT: 

8FNAME: 

@FSPEC: 

§HEXDEC: 

@INIT: 

@KBD: 

@KEYIN: 

@LOC: 

§OPEN: 

@READ: 

§R£MOV: 

@VER: 



EQU 
EQU 
EQU 
EQU 
EQU 
EQU 
EQU 
EQU 
EQU 
EQU 
EQU 
EQU 
EQU 
EQU 
EQU 
EQU 
EQU 
EQU 



60 

87 

2 

10 

26 

22 

79 

80 

78 

97 

58 

8 

9 

63 

59 

67 

57 

73 



Close a file or device 

Read a directory record 

Display character at cursor 

Display a message 

Display an error message 

Exit and return to TRSDOS or the caller 

Add a default file extension 

Fetch a filespec from the directory 

Verify and load a filespec into the FCB 

Convert a binary value to decimal ASCII 

Open an existing file or create a new file 

Scan the keyboard for a character 

Accept a line of text from the *KI device 

Return the current logical record number 

Open an existing file 

Read a record from an open file 

;Delete a file from disk 

,-Write a record to disk. Does the same thing 

;as 8WRITE (Svc 75), but it also makes sure 

;the written data is readable. 



First, prompt for the source filespec using the @DSPLY svc. 



BEGIN; LD HL,MESGl 
LD A,§DSPLY 
RST 28H 



;Get the first message 
;Display a line on the screen 
;Call the @DSPLY svc 



Now, read the filename from the keyboard using the @KEYIN svc. 

;Put the name of the 1st file here 

,-Allow up to 24 characters 

;A zero is required by the svc 

;Get a filename from the user 

;Call the @KEYIN svc 

;The user pressed <Break> 

;An Error .occurred 

;Get the number of characters 

;See if that value was zero 

; Nothing was entered, ask again 

The user has typed something, so it must be checked for validity 

using the iFSPEC svc. 



LD 


HL,FILE1 


LD 


B,24 


LD 


C,0 


LD 


A,@KEYIN 


RST 


28H 


JP 


C,QUIT 


JP 


NZ,ERR 


LD 


A,B 


OR 


A 


JR 


Z, BEGIN 



LD 
LD 



LD 



RST 

JR 



HL,FILE1 
DE,FCB1 

A,8FSPEC 



28H 
Z,ASK2 



;Point at the text the user entered 

jPoint at the File Control Block 

;that is to be used for the source file. 

;The iFSPEC svc will make sure the filename 

;that is in buffer named "filel" is valid. 

;If it is, it is copied into the File 

,-Control Block (FCB) to be used by the @OPEN 

;or @INIT svc later on. 

;Call the @FSPEC svc 

;The name for file 1 is ok, so skip this 



At this point the filename specified for file 1 has been found 
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Sample Program C, continued 



00339 

00340 

00341 

00342 

00343 

00344 

00345 

00346 

00347 

00348 

00349 

00350 

00351 

00352 

00353 

00354 

00355 

00356 

00357 

00358 

00359 

00360 

00361 

00362 

00363 

00364 

00365 

00366 

00367 

00368 

00369 

00370 

00371 

00372 

00373 

00374 

00375 

00376 

00377 

00378 

00379 

00380 

00381 

00382 

00383 

00384 

00385 

00386 

00387 

00388 

00389 

00390 

00391 

00392 

00393 

00394 

00395 

00396 

00397 

00398 

00399 

00400 

00401 

00402 

00403 

00404 

00405 



EOF: 



EOFYES : 



QUIT: 



ERR: 



SPACES: 

ARROW: 

OK: 

MESG1 : 
MESG2: 

FEXST: 



LD 


hl,buf: 


LD 


A,§VER 


RST 


28H 


JR 


NZ,ERR 



JR 



LOOP 



; Point at the data read from file 1 

;Write a record to the target file 

;The §VER does the same thing as the 

;§WRITE svc, only it also checks the 

;data to make sure it is readable. 

;Call the §VER svc 

;An error occurred on write; possibly 

;the disk is full. 

;Loop until an error occurs. 



CP 


28 


JR 


Z, EOFYES 


CP 


29 


JR 


NZ,ERR 



This code checks the error to make sure it was an end of file 
condition and, if so, closes the source & target files. 

;Was it an end of file encountered? 
;Yes, close the file 

;Was it "Record number out of range"? 
;No, must be some other error 

It is possible to get Error 29 if the file being copied has 
an EOF that is not a multiple of the file's LRL 

;Point at file 1 (source file) 

;Close the file 

;Call the §CLOSE svc 

;An error occurred, abort 

;Point at file 2 (target file) 

;Close it also 

;Call the §CLOSE svc 

;An error occurred, abort 

;Print a message saying the copy is done 

;Call the @DSPLY svc 

;Exit to TRSDOS or the calling program 
;Call the @EXIT svc 

The §EXIT svc does not return. 

OR 040H ;Turn on bit 6, which 

;will cause the §ERROR svc to print 

;the short error message. Bit 7 

;is not set, which instructs the §ERROR 

;to abort this program and return to 

; TRSDOS Ready. 

;Put error code & flags in register C 

;Call the system error displayer 

;Call the §ERROR svc 

Because bit 7 is not set, the §ERROR svc will not return. 

Storage Declaration 

;ASCII Space char. for display formatting 
;Arrow for display shows data direction 



LD 


DE,FCB1 


LD 


A,§CLOSE 


RST 


28H 


JR 


NZ,ERR 


LD 


DE,FCB2 


LD 


A,§CLOSE 


RST 


28H 


JR 


NZ,ERR 


LD 


HL,OK 


LD 


A,@DSPLY 


RST 


28H 


LD 


A,§EXIT 


RST 


28H 



LD 


C,A 


LD 


A,§ERROR 


RST 


28H 



DEFM 
DEFB 
DEFM 
DEFB 
DEFB 
DEFM 
DEFB 
DEFM 
DEFB 
DEFM 
DEFB 
DEFM 
DEFB 



3 

'=> 

3 

10%25 

• [Ok] 

0DH 



;Advance cursor 10 spaces without erasing 
;Used to indicate, the Copy is complete 
;Terminated with an <Enter> 



'Copy Filespec >' 

3 

•To Filespec >' 

3 

•Destination File Already Exists - Ok to Delete it (Y/N) ?' 
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Sample Program C, continued 



00406 
00407 
00408 

00409 
00410 
00411 
00412 
00413 
00414 
00415 
00416 
00417 
00418 
00419 
00420 
00421 
00422 
00423 
00424 



BADFIL: DEFM 

DEFB 

LOCMSG: DEPM 

DEFB 
DEFB 



FILE1: 

FILE 2: 

FCB1: 

FCB2: 

COPY: 

LRL: 



DEFS 
DEFS 

DEFS 
DEFS 
DEFS 
DEFB 



•Invalid Filename - Try Again' 
0DH 

' 12345 5' ;This will be used in building the LOC 
;Display will appear as (d) to (ddddd). 
7%24 iBackspace without erasing 



BUF1: DEFS 
B0F2: DEFS 
BUFFER: DEFS 

END 



32 
32 
32 
32 
32 


256 
256 

256 

BEGIN 



;Etx, used to get the fDSPLY svc to stop 

?Oser Text Originally placed here 

^Target Filename goes here 

;32 bytes for the File Control Block 

j 32 bytes for the File Control Block 

;hn extra copy of the target FCB goes here 

?The Logical Record Length of the source 

;file will be stored here 

^System buffer for Pile 1 

;System buffer for File 2 

iData buffer for both files 

j "begin" is the starting address 
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Sample Program F, continued 



00313 


OR 


A 


00314 






00315 


RET 


Z 


00316 


PUSH 


HL 


00317 


PUSH 


DE 


00318 


PUSH 


BC 


00319 


LD 


C,A 


00320 


LD 


A,@VDCTL 


00321 


RST 


28H 


00322 


POP 


BC 


00323 


POP 


DE 


00324 


POP 


HL 


00325 


INC 


L 


00326 


INC 


DE 


00327 


JR 


TSKLP 


00328 






00329 


MODEND: END 


BEGIN 



j Is it time to stop putting this on 

;the display? 

;Yes, return to the caller 

;Save the registers, as the SVC will 

;alter the contents 

;Put the character here 

;Put character on screen at specified' position 

,-Call the @VDCTL svc 

;Restore registers 



;Advance display position 

;Point to next character to display 

;Loop till date is completely displayed 

;End of task and main program 



359 



Sample Program G 



00001 
00002 
00003 
00004 
00005 
00006 
00001 
00008 
00009 
00010 
00011 
00012 
00013 
00014 
00015 
00016 
00017 
00018 
00019 
00020 
00021 
00022 
00023 
00024 
00025 
00026 
00027 
00028 
00029 
00030 
00031 
00032 
0003 3 

0003 4 
00035 
00036 
00037 

00038 ; 

00039 ; 
00040 

00041 ; 

00042 ; 

00043 ; 

0004 4 
00045 
00046 

00047 ; 

00048 ; 
00049 
00050 
00051 

0005 2 
00053 
00054 ; 
00055 

00056 ; 

00057 §EXIT: 

00058 @DSPLY: 

0005 9 @ FLAGS: 

00060 @DODIR: 

00061 @KEYIN: 

00062 §CMNDI: 
00063 

00064 
00065 

0006 6 
0006 7 
0006 8 



This program is 
may make the EC 
use allof main 
system overlay 
To pass a comma 
processing, use 
and reloads the 
points, Bits 2 
(in Bits 6-4) 
EFLAG$ is total 
non-zero value, 
own interpreter 
should set the 
svc. 



a sample Extended Command Interpreter. You 

I as large or small as you require. You may 

memory, or you can restrict yourself to the 

area (x'2600' to x'2FFF'). 

nd to the normal system interpreter for 
the @CMNDI svc. TRSDOS executes the command 
ECI. If you want to have multiple entry 

- in EFLAG$ are in Register A on entry 

,or you may read EFLAG$ yourself. 

ly dedicated to the ECI, and may contain any 
If EFLAG$ contains a zero, TRSDOS uses its 
Other programs that want to activate an ECI, 

EFLAG$ to a non-zero value and execute a @EXIT 



To install an ECI, use the command: 

COPY filename SYS13/SYS .LSIDOS : d (C=N) 
If you omit the C=N option, the SYS13 file loses it's "SYS" 
status and you will receive 'Error 07' messages when you try 
to use it as a ECI. 

When SYS1 (the normal command interpreter) has completed it's 
normal housekeeping and is about to display the "TRSDOS Ready" 
prompt, it checks EFLAG$ . If EFLAG$ contains a non-zero 
value, TRSDOS loads and executes the Extended Command 
Interpreter . 
To execute this program, type <*><Enter>. 

This program checks EFLAG$ to see if it is zero. If so, it 
sets it to a non-zero value. This causes this program to be 
used instead of the normal interpreter when you execute an 
@EXIT or @ABORT SVC. (@CMNDI and @CMNDR invoke the TRSDOS 
interpreter.) If EFLAG$ is non-zero, the ECI displays a few 
prompts and the names of all visible /CMD files on logical 
Drive 0. 
The operator may then type the name of a program to execute. 

If you press <Break>, this program sets EFLAG$ to 0, executes 
an @EXIT SVC and returns to TRSDOS Ready. 

By pressing a number, through 7, you can specify the drive 
that TRSDOS searches. This program stores this value in 
EFLAG$. Each time this program is invoked, it reads the value 
from EFLAG$ and uses that drive. 

Note that if a drive is not enabled, not formatted, doesn't 
exist, or contains no visible /CMD files, this program 
redisplays the prompt. 



PRINT SHORT, NOMAC 
PSECT 3000H 



;This program starts at x'3000' 



Declare the equates for the SVCs used. 

This is not mandatory, but it makes the program easier to 

follow. 



EQU 
EQU 
EQU 
EQU 
EQU 
EQU 



22 

10 

101 

34 

9 

24 



;Exit and return to TRSDOS 

;Display a string 

;Locate the system flag area 

;Get the names of filenames 

;Accept a command and allow editing 

;Execute a command (using SYS1) 



On entry, determine if EFLAG$ is set to zero or not. If it 
is set to zero, this program is being started by typing 
PROGRAM<Enter> or <*><Enter>. In that case, set EFLAG$ to a 
non-zero value so that in future, TRSDOS uses this interpreter 
instead of it's own. 
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0006 9 
00070 
00071 
00072 
area 

0007 3 
00074 
00075 
00076 
0007 7 
0007 8 
0007 9 
00080 
00081 
00082 
00083 
00084 
00085 
00086 
00087 
00088 
00089 
00090 
00091 
00092 
00093 
00094 
00095 
00096 
00097 
00098 
00099 
00100 
00101 
00102 
00103 
00104 
00105 
00106 
00107 
00108 
00109 
00110 
00111 
00112 
00113 
00114 
00115 
00116 
00117 
00118 
00119 
00120 
00121 
0012 2 
00123 
00124 
00125 
00126 
00127 
00128 
00129 
00130 
00131 
00132 
00133 
00134 
00135 
00136 



Sample Program G, continued 

If EFLAG$ is non-zero, this initialization has already been 
done and can be skipped. 



BEGIN: 



LD 

RST 

LD 
OR 
JR 

LD 



LD 
LD 
JR 



A, § FLAGS 

28H 

A, (IY+4) 

A 

NZ,ECIRUN 

A, 8 



(IY+4) ,A 
HL , PROMPT 
ECIGO 



;Get the starting address of the flag 

;Call the § FLAGS svc 

;Read the EFLAG$ (ECI flag) 
;Is it set to zero? 
;Run the ECI 

;Get a non-zero value. The value 
; needs to be a non-zero value that 
;does not set Bits 0, 1 or 2. The 
;default drive # is kept in these bits. 
;Set the EFLAG$ to a non-zero value 
;Explain how this works 
;Display message 



ASK: 



LD 


A, (IY+4) 


AND 


7 


LD 


C,A 


LD 


A,@DODIR 


LD 


B,2 


LD 


HL,CMDTXT 


RST 


28H 



; When the system is about to display 

; TRSDOS Ready, it executes this code instead. 

ECIRUN: LD HL,SPROMPT /Point at the prompt to use 
ECIGO: LD A,@DSPLY /Display the prompt 
RST 28H ;Call the @DSPLY svc 

; Display the names of all /CMD files 



;Get the EFLAG$ 

;Delete all but the drive number field 

/Store the drive number for the svc 

;Do a directory display 

/Display visible, non-system files 

/that match "CMD" (stored at CMDTXT) 

;Call the @DODIR svc 

Prompt for a filename or a function key. 

/Point at text buffer 

/Allow up to 8 characters and <Enter> 

/Required by the svc 

/Input text with edit capability 

/Call the @KEYIN svc 

/The carry flag is set when the 
/operator presses <BREAK>. Zero the 
/EFLAG$ and exit to TRSDOS 

/Point at the start of the buffer 
/Get the character 

/Did they type anything? 
/No, just repeat the prompt. 
/If you want to redisplay the 

/directory, change "ASK" to "ECIRUN". 

/Convert value to binary 
/Is the character a - 7? 
/Must be a filename 

The operator has typed 1 or more characters that start with 

a number. This program assumes that the operator is defining 

a new drive number and stores this value in EFLAG$ for 

future use. TRSDOS does not alter this value. 

The next time this program is run, EFLAGS contains the 

same value and this program knows what drive to scan. 



LD 


HL, BUFFER 


LD 


B,9 


LD 


C,0 


LD 


A,@KEYIN 


RST 


28H 



JR 



CQUIT 



LD 


HL, BUFFER 


LD 


A, (HL) 


CP 


0DH 


JR 


Z,ASK 


SUB 


'0' 


CP 


7+1 


JR 


NC , NAME 



LD 
LD 



B,A 

A, (IY+4) 



/Save the drive number 
/Get the EFLAG$ 
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Sample Program G, continued 



NAME: 
FDIV: 



00137 
00138 
00139 
00140 
00141 

00142 ; 

00143 j 

00144 QUIT s 
00145 
00146 
00147 
00148 
00149 
00150 
00151 

00152 -, 

00153 ; 
00154 
0015 5 
00156 
00157 
00158 
00159 
00160 
00161 
00162 
00163 
00164- 
EFLAG$. 
00165 
00166 
00167 
00168 
00169 
00170 
00171 
00172 
00173 
00174 
00175 
00176 
00177 
00178 
00179 
00179 
00180 
00181 
0018 2 
00183 
00184 
00185 
00186 
00187 
00188 
00189 
00190 
00191 

00192 
00193 

00194 

00195 

00196 SPROMPT: 

00197 



FOUND: 



AND 
OR 
LD 
JR 



(IY+4) ,A 
ECIRUN 



;Delete the old drive number 
; Insert the new drive number 
;Save that value for future use 
;Scan the new drive 



The operator pressed <Break>. Turn off the ECI and return to 

TRSDOS. 

XOR A ;Get a zero 

LD (IY+4), A ;Set EFLAG$ to zero 

LD HL,EPROMPT ;Point at the shutdown message 

BD A,(lDSPLY ;And acknowledge the <Break> 

RST 28H fCall the @DSPLY svc 

LD A,@EXIT ; Return to TRSDOS Ready 

RST 28H ?Call the @EXIT svc 

The operator entered what might be a filename or a library 
command. Pass it to TRSDOS for processing. If there is an 
error, TRSDOS is responsible for determining what the error is 
and printing a message. 
(HL already points at the start of the buffer.) 



LD 

CP 

JR 

INC 

JR 



A,0DH 

(HL) 

Z, FOUND 

HL 

FDIV 



;Look for this character 

;In the command 

;Found the end of the filename 

;Move character to next byte 

;Find the divider (in this case, a 0DH) 



Found the end of a filename, and add the drive number from 

Note that this program may not work properly if the operator 
supplies a drive number as part of the filename. 



LD 

INC 

LD 

AND 

ADD 

LD 

INC 

LD 

LD 

LD 



(HL), ■ :■ 

HL 

A, (IY+4) 

7 

A,'0' 

( HL ) , A 

HL 

(HL) ,0DH 

HL, BUFFER 

A,@CMNDI 



RST 



28H 



;Add a drive number to the filename 

^Advance the pointer to the next byte 

;Get the EFLAG$ value 

;Delete all but the drive number 

^Convert the binary value to ASCII 

;Add that to the filename 

;Advance the pointer to the next byte 

;Write a terminator on the end 

;Point at the text entered 

; Execute the command, but do not 

;return. Since this program is the 

command processor at this time, TRSDOS 

;returns control to the beginning of 

;this module after executing the 

; command. 

jCall the §CMNDI svc 



Messages and text storage 



PROMPT: 



00198 
00199 
00200 



DEFM '[Extended Command Interpreter Is Now Operational]* 

DEFB 0AH 

DEFB 0AH 

DEFM 'Press <BREAK> to use the normal interpreter,' 

DEFB 0AH 

DEFM 'type <NumberXENTER> to change the default drive 

number, ' 
DEFB 0AH 
DEFM 'or type the name of the program to run and press 

<ENTER>' 
DEFB 0DH ,-Terminate the display 

: DEFB 0AH 
DEFM '[ECI On] <BREAK> to abort, n<ENTER> for new drive or 

type: ' 
DEFM ' program<ENTER>' 
DEFB 0DH ; Terminate the message 
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Sample Program G, continued 



00201 EPROMPT:DEFM '[Extended Command Interpreter- Is Now Disabled]' 

00202 DEFB 0DH 
00203 

00204 CMDTXTj DEFM 'CMD' 

00205 BUFFER: DEFS 11 ,-Allow for filename, drivespec and 0DH 
00206 

$0207 END BEGIN ; "BEGIN" is the starting address 



oou.d 



HIT read error (Error 22, X'16') 

A disk error occurred during the reading of the Hash Index Table. The problem 
may be media, hardware, or program failure. Move the diskette to another drive 
and try the operation again. 

HIT write error (Error 23, X'17') 

A disk error occurred during the writing of the Hash Index Table. The HIT may 
no longer be reliable. If the problem recurs, use a different drive or different 
diskette. 

Illegal access attempted to protected file (Error 37, X'25') 

The USER password was given for access to a file, but the requested access 
required the OWNER password. (See the ATTRIB library command in your 
Disk System Owner's Manual.) 

Illegal drive number (Error 32, X'20') 

The specified disk drive is not included in your system or is not ready for access 
(no diskette, non-TRSDOS diskette, drive door open, and so on). See the 
DEVICE command in your Disk System Owner's Manual.) 

Illegal file name (Error 19, X'13') 

The specified filespec does not meet TRSDOS filespec requirements. See your 
Disk System Owner's Manual for proper filespec syntax. 

Illegal logical file number (Error 16, X'10') 

A bad Directory Entry Code (DEC) was found in the File Control Block (FCB). 
This usually indicates that your program has altered the FCB improperly. Check 
for an error in your application program. 

Load file format error (Error 34, X'22') 

An attempt was made to load a file that cannot be loaded by the system loader. 
The file was probably a data file or a BASIC program file. 

Lost data during read (Error 3, X'03') 

During a sector read, the CPU did not accept a byte from the Floppy Disk Con- 
troller (FDC) data register in the time allotted. The byte was lost. This may indi- 
cate a hardware problem with the drive. Move the diskette to another drive and 
try again. If the error recurs, try another diskette. 

Lost data during write (Error 11, X'0B') 

During a sector write, the CPU did "not transfer a byte to the Floppy Disk Con- 
troller (FDC) in the time allotted. The byte was lost; it was not transferred to the 
disk. This may indicate a hardware problem with the drive. Move the diskette to 
another drive and try again. If the error recurs, try another diskette. 

LRL open fault (Error 42, X'2A') 

The logical record length specified when the file was opened is different than 
the LRL used when the file was created. COPY the file to another file that has 
the specified LRL. 

No device space available (Error 33, X'21') 

You tried to SET a driver or filter and all of the Device Control Blocks were in 
use. Use the DEVICE command to see if any non-system devices can be 
removed to provide more space. This error also occurs on a "global" request to 
initialize a new file (that is, no drive was specified), if no file can be created. 

No directory space available (Error 26, X'1 A') 

You tried to open a new file and no space was left in the directory. Use a differ- 
ent disk or REMOVE some files that you no longer need. 
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No error (Error S) 

The ©ERROR supervisor call was called without any error condition being 
detected. A return code of zero indicates no error. Check for an error in your 
application program. 

Parameter error (Error 44,X'2C) 

(Under Version 6.2 only) An error occurred while executing a command line or 
utility because a parameter that does not exist was specified. Check the spell- 
ing of the parameter name, value, or abbreviation. 

Parity error during header read (Error 1, X'OT) 

During a sector I/O request, the system could not read the sector header suc- 
cessfully. If this error occurs repeatedly, the problem is probably media or hard- 
ware failure. Try the operation again, using a different drive or diskette. 

Parity error during header write (Error 9, X'09') 

During a sector write, the system could not write the sector header satisfactor- 
ily. If this error occurs repeatedly, the problem is probably media or hardware 
failure. Try the operation again, using a different drive or diskette. 

Parity error during read (Error 4, X'04') 

An error occurred during a sector read. Its probable cause is media failure or a 
dirty or faulty disk drive. Try the operation again, using a different drive or 

diskette. 

Parity error during write (Error 12, X'OC) 

An error occurred during a sector write operation, its probable cause is media 
failure or a dirty or faulty disk drive. Try the operation again, using a different 
drive or diskette. 

Program not found (Error 31, Xi F) 

The file cannot be loaded because it is not in the directory. Either the filespec 
was misspelled or the disk that contains the file was not loaded. 

Protected system device (Error 40, X'28') 

You cannot REMOVE any of the following devices: *KI, *DO, *PR, *JL, *St, *SO. 

If you try, you get this error message. 

Record number out of range (Error 29, X'1 D') 

A request to read a record within a random access file (see the @POSN super- 
visor call) provided a record number that was beyond the"end of the file. Correct 
the record number or try again using another copy of the file. 

Seek error during read (Error 2, X*82*) 

During a read sector disk I/O request, the cylinder that should contain the sec- 
tor was not found within the time allotted. (The time is set by the step rate spec- 
ified in the Drive Code Table.) Either the cylinder is not formatted or it is no 
longer readable, or the step rate is too low for the hardware to respond. You can 
set an appropriate step rate using the SYSTEM library command. The problem 
may also be caused by media or hardware failure. In this case, try the operation 
again, using a different drive or diskette. 

Seek error during write (Error 18, X'BA*) 

During a sector write, the cylinder that should contain the sector was not found 
within the time allotted. (The time is set by the step rate specified in the Drive 
Code Table.) Either the cylinder is not formatted or it is no longer readable, or 
the step rate is too low for the hardware to respond. You can set an appropriate 
step rate using the SYSTEM library command. The problem may also be 
caused by media or hardware failure. In this case, try the operation again, using 
a different drive or diskette. 
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— Unknown error code 

The ©ERROR supervisor call was called with an error number that is not 
defined. Check for an error in your application program. 

Write fault on disk drive (Error 14, X'0E') 

An error occurred during a write operation. This probably indicates a hardware 
problem. Try a different diskette or drive. If the problem continues, contact a 
Radio Shack Service Center. 

Write protected disk (Error 15, XW) 

You tried to write to a drive that has a write-protected diskette or is software 
write-protected. Remove the write-protect tab, if the diskette has one. If it does 
not, use the DEVICE command to see if the drive is set as write protected. If it 
is, you can use the SYSTEM library command with the (WP = OFF) parameter 
to write enable the drive. If the problem recurs, use a different drive or different 
diskette. 

Numerical List of Error Messages 

Message 

No Error 

Parity error during header read 

Seek error during read 

Lost data during read 

Parity error during read 

Data record not found during read 

Attempted to read system data record 

Attempted to read locked/deleted data record 

Device not available 

Parity error during header write 

Seek error during write 

Lost data during write 

Parity error during write 

Data record not found during write 

Write fault on disk drive 

Write protected disk 

Illegal logical file number 

Directory read error 

Directory write error 

Illegal file name 

GAT read error 

GAT write error 

HIT read error 

HIT write error 

File not in directory 

File access denied 

Full or write protected disk 

Disk space full 

End of file encountered 

Record number out of range 

Directory Full — can't extend file 

Program not found 

Illegal drive number 

No device space available 

Load file format error 

Illegal access attempted to protected file 

File not open 

Device in use 

Protected system device 






Decimai 


Hex 





XW 


1 


X'01' 


2 


X'02' 


3 


X'03' 


4 


X'04' 


5 


X'05' 


6 


X'06' 


7 


X'07' 


8 


X'08' 


9 


XW 


10 


X'0A 


11 


X'OB' 


12 


X'0C 


13 


XW 


14 


X'OE' 


15 


X0F 


16 


X'10* 


17 


x'ir 


18 


X'12' 


19 


X'13' 


20 


X'14' 


21 


X'15' 


22 


X'16* 


23 


X'17' 


24 


X'18' 


25 


X'19" 


26 


X'1A' 


27 


X1B' 


28 


X'1C 


29 


X'1D' 


30 


X'1E' 


31 


X'1F 


32 


X'20' 


33 


X'21" 


34 


X'22' 


37 


X'25' 


38 


X'26' 


39 


X'27' 


40 


X'28" 



41 X'29' File already open 

42 X'2A' LRL open fault 

43 X'2B' SVC parameter error 
63 X'3F' Extended error 

— Unknown error code 
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Appendix D Keyboard Code Map 



The keyboard code map shows the code that TRSDOS returns for each key, in 
each of the modes: control, shift, unshift, clear and control, clear and shift, clear 
and unshift. 

For example, pressing (CLEAR) . (HlFD . and CD at the same time returns the code 
X'Al' 

A program executing under TRSDOS — for example, BASIC — may translate 
some of these codes into other values. Consult the program's documentation 
for details. 

(BREAK) Key Handling 

The (BREAK) key (X'80') is handled in different ways, depending on the settings 
of three system functions. The table below shows what happens for each com- 
bination of settings. 

Break Break T yP e " 

c„LwL Vector Ahead 
enabled ~ . _ . . . 

Set Enabled 

Y N Y If characters are in the type-ahead buffer, 

then the buffer is emptied* 

If the type-ahead buffer is empty, then a 
BREAK character (X'80') is placed in the 
buffer* 



Y 


N 


N 


A BREAK character (X'80') is placed in the 
buffer. 


Y 


Y 


Y 


The type-ahead buffer is emptied of its con- 
tents (if any), and control is transferred to the 
address in the BREAK vector (see ©BREAK 
SVC).* 


Y 


Y 


N 


Control is transferred to the address in the 
BREAK vector (see ©BREAK SVC). 


N 


X 


X 


No action is taken and characters in the type- 
ahead buffer are not affected. 



*Because the (BREAK) key is checke d for more frequently than other keys on the 
keyboard, it is possible for (BREAK) to be pressed after another key on the key- 
board and yet be detected first. 

Y means that the function is on or enabled 
N means that the function is off or disabled 
X means that the state of the function has no effect 

Break is enabled with the SYSTEM (BREAK = ON) command (this is the 

default condition). 
The break vector is set using the ©BREAK SVC (normally off). 
Type-ahead is enabled using the SYSTEM (TYPE = ON) command (this is the 

default condition). 
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Appendix E/Programmable S¥Cs 

(Under Version 6.2 only) 

SVC numbers 124 through 127 are reserved for programmer installable SVCs. 
To install an SVC the programmer must write the routine to execute when the 
SVC is called. 

The routine should be written as high memory module if it is to be available at 
all times. If you execute a SYSGEN command when a programmable SVC is 
defined, the address of the routine is saved in the SYSGEN file and restored 
each time the system is configured. If the routine is a high memory module, the 
routine is saved and restored as well. This makes the SVC always available. 
For more information on high memory modules, see Memory Header and Sam- 
ple Program F. 

To install an SVC, the program must access the SVC table. The SVC table con- 
tains 1 28 two-byte positions, a two-byte position for each usable SVC. Each po- 
sition in the table contains the address of the routine to execute when the SVC 
is called. 

To access the SVC table, execute the ©FLAGS SVC (SVC 101). IY + 26 con- 
tains the MSB of the SVC table start address. The LSB of the SVC table ad- 
dress is always because the SVC table always begins on a page boundary. 

Store the address of the routine to be executed at the SVC number times 2 byte 
in the table. For example, if you are installing SVC 1 26, store the address of the 
routine at byte 252 in the table. Addresses are stored in LSB-MSB format. 

When the SVC is executed, control is transferred to the address in the table. On 
entry to your SVC, Register A contains the same value as Register C. All other 
registers retain the values they had when the RST 28 SVC instruction was 
executed. 

To exit the SVC, execute a RET instruction. The program should save and re- 
store any registers used by the SVC. 

Initially, SVCs 124 through 127 display an error message when they are exe- 
cuted. When installing an SVC you should save the original address at that lo- 
cation in the table and restore it when you remove the SVC. 

These program lines insert a new SVC into the system SVC table, save the pre- 
vious value of the table, and reinsert that value before execution ends. You 
could check the existing value to see if the address is above X'2600'. If it is, the 
SVC is already assigned and should not be used at this time. 

This code inserts SVC 126, called MYSVC: 



LD 


A, (3) FLAGS 


Locate start of SVC table 


RST 


28H 


Execute ©FLAGS SVC 


LD 


H.0Y + 26) 


Get MSB of address 


LD 


L, 126*2 


Want to use SVC 1 26 


LD 


(OSVC126A),HL 


Save address of SVC entry 


LD 


E,(HL) 


Get current SVC address 


INC 


HL 




LD 


D,(HL) 




LD 


(OSVC128V),DE 


Save the old value 


DEC 


HL 




LD 


DE.MYSVC 


Get address of routine for 
SVC 128 


LD 


(HL),E 


Insert new SVC address into 
table 



INC HL 
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LD 



(HL),D 



Code that uses MYSVC (SVC 126) 



This code removes SVC 126: 



LD 


HL,(OSVC126A) 


;Get address of SVC entry 


LD 


DE,(OSVC126V) 


;Get original value 


LD 


(HL),E 


;lnsert original SVC address 


INC 


HL 




LD 


(HL),D 
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Appendix F/Using SYS13/SYS 

(Under Version 6.2 only) 

With TRSDOS Version 6.2, you can create an Extended Command Inter- 
preter (ECI) or an Immediate Execution Program (IEP). TRSDOS can store 
either an ECI or IEP in the SYS13 file. Both programs cannot be present at 
the same time. 

At the TRSDOS Ready prompt when you type CD (ENTER) . TRSDOS exe- 
cutes the program stored in SYS13/SYS. Because TRSDOS recognizes the 
program as a system file, TRSDOS includes the file when creating backups 
and loads the program faster. 

If you want to write additional commands for TRSDOS, you can write an in- 
terpreter to execute these commands. Your ECI can also execute TRSDOS 
commands by using the @CMNDI SVC to pass a command to the 
TRSDOS interpreter. 

If EFLAG$ contains a non-zero value, TRSDOS executes the program in 
SYS13/SYS. If EFLAG$ contains a zero, TRSDOS uses its own command 
interpreter. 

Sample Program G is an example of an ECI . It is important to note that your ECI 
must be executable by pressing CD (ENTER) at the TRSDOS Ready prompt. 

An ECI can use all of memory or you can restrict it to use the system overlay 
area (X'2600' to X'2FFF'). 

To implement an IEP or ECI, use the following syntax: 



COPY filespec SYS13/SYS.LSIDOS:c/r/Ve (C = N) (ENTER) 

filespec can be any executable (/CMD) program file, drive specifies the desti- 
nation drive. The destination drive must contain an original SYS13/SYS file. 

Example 

COPY SCRIPSIT/CMD:1 SYS13/SYS.LDI:0 (C = N) 

TRSDOS copies SCRIPSIT/CMD from Drive 1 to SYS13/SYS in Drive 0. At the 
TRSDOS Ready prompt, when you press C*D (ENTER) , TRSDOS executes 
SCRIPSIT. 
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Index 



Subject 



Page Subject 



Page 



@ABORT 230 

Access 

device 191-192 

drive 193-203 

file 186 

Address decoding 15 

Adjustment, drive motor 93 

Adjustments, FDC 61 

@ADTSK 231 

Alien disk controller 194 

Alignment, disk drive 93 

Allocation 

dynamic 185 

information 194, 207 

methods of 1 85 

pre- 1 85 

unit of 184 

ASCII codes 374-376 

Background tasks, invoking 215-216 

@BANK 219-221 , 232-233 

Bank switching 21 8-221 

Baud 15, 21 

Baud rate generator 1 69 

@BKSP 234 

BOOT/SYS 187 

BREAK 

detection 21 1-214, 235 

key handling 383 

@BREAK 235 

Buffering 15, 59, 69 

Byte I/O 222-224 

Carriage movement 93 

CASIN* 29 

CASOUT* 28 

Cassette circuitry 21 

Cat eyes adjustment 94 

Characters 

ASCII 374-376 

codes 373-382 

graphics 377-378, 380 

special 378-379, 381-382 

@CHNIO 236 

@CKDRV 237 

@CKBRKC 236.1 

@CKEOF 238 

@CKTSK 239 

Cleaning the magnetic head 93 

Clock generation 60, 70 

Clock rate, changing 363 

@CLOSE 240 



@CLS 240.1 

(ffiCMNDI 241 

@CMNDR 242 

Codes 

ASCII 374-376 

character 373-382 

error 369 

graphics 377-378, 380 

keyboard 383-384 

return 210 

special character .... 378-379, 381-382 

Compensated write data 88 

Compliance check 96 

Control chain 132 

Controller, CRT 19 

Controller, floppy disk 9 

Converting to TRSDOS Version 6 .. 209-210 

CPU board 9, 10, 11, 15 

CREATEd files 197 

Crowbar 113, 124 

CRT 10, 11 

@CTL 222-224, 243-244 

interfacing to device drivers . . . 224-226 

Current limit circuit 130 

Cylinder 

highest numbered 194 

number of 200 

position, current 1 94 

starting 207 

@DATE 245 

@DCINIT 246 

@DCRES 247 

@DCSTAT 248 

DEBUG 188 

@DEBUG 249 

@DECHEX 250 

Decoding, address 15 

Density, double and single 183, 193, 200 

Device 

access 191-192 

handling 209 

NIL 191 

Device Control Block (DCB) 191 

Device driver 1 89, 1 90, 1 95 

address 191 

COM 225-226 

@CTL interfacing to 224-226 

keyboard 225 

printer 225 

templates 222-224 
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video , 225 

Devspec 191 

Directory 

location on disk 1 84, 1 94 

primary and extended entries 196, 

198, 202 

record, locating a 202 

records (DIREC) 195-198 

sectors, number of 196 

Directory Entry Code (DEC) 200-201 , 

202, 206 

@DIRRD 251 

DIR/SYS 187 

@DIRWR 252 

Disk drive 9, 10, 11, 81 

Disk, diskette 81 

controller 194 

double-sided 193-194, 199, 200 

files 185-186 

floppy 183 

formatting 199, 200 

hard 184 

I/O table 195 

minimum configuration 189-190 

name 200 

organization 183-184 

single-sided 193-194, 199, 200 

space, available 184 

@DIV8 253 

@DIV16 254 

@DODIR 255-256 

Drive 

access 1 93-204 

address 194 

floppy 183, 193 

hard 184, 193 

size 1 93 

Drive Code Table DCT 193-195 

Drive motor adjustment 93 

Drive select 59, 70, 88 

Driver — see Device driver 

DRVSEL* 29 

@DSP 257 

@DSPLY 258 

Duty cycle 1 27 

End of File (EOF) 197 

Ending Record Number (ERN) 198, 207 

ENTER detection 21 1-214 

Environmental specs, power supply 124 

Erase gaps 85 



Error 

codes and messages 365-369 

dictionary 1 88 

©ERROR 259 

@EXIT 260 

Extended Command Interpreter 262, 387 

External disk drive 81 

FDC controller 9,10,11,59, 

61 , 69, 72 

Feedback control, power supply 109 

@FEXT 261 

File 

access 1 86 

descriptions, TRSDOS 187-190 

modification 1 97 

File Control Block (FCB) 205 

Files 

CREATEd 197 

device driver 1 89 

filter 189 

system (/SYS). . . 187-188, 189-190, 201 

utility 189 

Filter templates 222-224 

Filters 189, 190, 222-224 

example of 224 

©FLAGS 210, 262-263 

Floppy disk data separator 72 

Flyback converter 121 

@FNAME 264 

@FSPEC 265 

Fusing, power supply 109, 1 12 

@GET 222-224, 266 

Gran, granule 

allocation information 207 

definition 184, 199 

per track 183-184, 194 

Granule Allocation Table (GAT) 

location on disk 1 84 

contents of 1 98-200 

Graphics 

characters, printing 362 

codes 377-378, 380 

@GTDCB 267 

@GTDCT 268 

@GTMOD 269 

Guidelines, programming 209-226 

Hash code 1 97, 200 

Hash Index Table (HIT) 

location on disk 1 84 

explanation of 200-201 
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@HDFMT 270 

Head amplitude 96 

Head, disk drive 93 

Head positioning 84 

@HEXDEC 271 

@HEX8 272 

@HEX16 273 

@HIGH$ 274 

Hold-Up time, power supply 124 

Horizontal linearity 146 

@ICNFG, interfacing to 214-215 

I/O bus 26 

Immediate Execution Program 387 

Index pulse 84, 90 

Index sector timing 95 

Index sensor 81 84 

@INIT 275 

Initialization configuration 

vector 214-215 

Input line terminator 91 

Interrupt tasks 21 6-21 8 

Interrupts 59, 69, 1 70 

@IPL 276 

Job Control Language (JCL) 188, 210 

Jumper options 5 

@KBD 277 

@KEY 278 

Keyboard 19 

Keyboard codes 383-384 

@KEYIN 279 

KFLAG$ 211 

Kick start latch 125 

@KITSK, interfacing to 215-216 

@KLTSK 280 

Library commands 210 

technical information on 361-363 

@LOAD 281 

Load board values, power supply 114 

@LOC 282 

@LOF 283 

LOG utility 362 

@LOGER 284 

Logic board, disk drive 91 

Logical Record Length (LRL) 197, 206 

@LOGOT 285 

Low voltage outputs 1 1 3, 1 30 

Memory address decoding 18 

Memory banks — see RAM banks 

Memory header 192, 209 

Memory map 1 8, 371 



Minimum configuration disk 189 

Modification date 1 97 

MODOUT 28 

Motor adjustment, disk drive 93 

@MSG 286 

@MUL8 287 

@MUL16 288 

Next Record Number (NRN) 206 

NIL device 191 

NMI logic 59, 69 

@OPEN .289 

Oscillator 15 

Overlays, system 187-188, 201 

Over-Current protection 1 24 

Over- Voltage protection 1 09, 1 24, 1 31 

PAL circuits 15 

@PARAM 290-291 

Password 

for TRSDOS files 1 90 

protection levels 1 96, 206 

©PAUSE 292 

PAUSE detection 21 1-214 

@PEOF 293 

Port address decoding 15 

Port bit map 18, 28, 171 

@POSN 294 

Power supplies 9, 10, 11, 

109, 112, 121 

Precompensation, write 60 

Preventive maintenance 93 

©PRINT 295 

Printer status 21 

Printing Graphics Characters 362 

Programming Guidelines 209-226 

Protection Levels 196, 206, 209 

@PRT 296 

@PUT 222-224, 297 

Radial Alignment, Head 94 

RAM 19, 20 

RAM Banks 

switching 21 8-221 

use of 232-233 

@RAMDIR 2998 

@RDHDR 299 

RDINSTATUS* 28 

RDNMISTATUS* 28 

@RDSEC 300 

@RDSSC 301 

@RDTRK 302 

@READ , 303 
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Read Data Pulse 

Real Time Clock 

Record 

length 

logical and physical 

numbers 

processing 

spanning 

Rectifier 

@REMOV 

@RENAM 

Resistor Termination — 
Restart Vectors (RSTs) . 

Return Code (RC) 

@REW 

RFI Shield 

Ripple Specifications 

@RMTSK 

ROM 

@RPTSK 

@RREAD 

RS-232 

initializing 

COM driver for 

RS-232 Board 

@RSLCT 

@RSTOR 

@RUN 

@RWRIT 

Sample Programs 

A 

B 

C 

D 

E 

F 

Sectors 

per cylinder 

per granule 

©SEEK 

@SEEKSC 

©SKIP 

@SLCT 

Snubber Circuit 

©SOUND 

Sound Option 

Special Character Codes 

Spindle Drive 

Stack handling 

Step rate 



86, 90 

21 

185-186, 197, 206 
185-186 

186 

186 

185-186 

113 

304 

305 

83 

211 

210 

306 

9 

114, 124 

307 

19 

308 

309 

214 

225-226 

9, 11, 169 

310 

311 

312 

313 

336-359 

337-338 

339-343 

344-350 

351-352 

353 

354-359 

196,201 

. ... 183-184, 194 

314 

315 

316 

317 

129 

318 

22 

378-379, 381-382 

84 

210 

193 



changing 

©STEPI 

Stepper motor 

Supervisor calls (SVCs) 

calling procedure 

lists of 228-229,331 

program entry and 

return conditions 

sample programs using . . . 

using 

Surge limiter 

SYS files 187-188, 

System 

files 187-188, 

overlays 

Task 

interrupt level, adding 

slots 

Task Control Block (TCB) .... 

Vector Table (TCBVT) ... 
Task processor, interfacing to . 

©TIME 

Timing, CPU 

Track 00 Alignment 

Track 00 Switch 

Trim erase 

TRSDOS 

converting to Version 6 . . 

error messages and codes 

file descriptions 

technical information on 
commands and utilities 

TYPE code 

Under-Voltage Lockout 

©VDCTL 

©VER 

Version, operating system 

Video Controller 

Video Monitor 

Visibility 

Voltage Controlled Oscillator . . 

Voltage Regulation 

©VRSEC 

Wait State 

WAIT value, changing 

©WEOF 

©WHERE 

WRINTMASKREG* 

©WRITE 

Write Enable 



361 

319 

81 

227 

■333, 334-335 

227 

.... 336-359 
.... 227-359 

124 

189-190,201 

189-190,201 
187-188, 201 

231 

216, 217, 231 

216, 217,231 

... 216, 217 

.... 216-218 

320 

15 

95 

84, 90 

86 

.... 209-210 
.... 365-369 
.... 187-190 

.... 361-363 

205 

130 

.... 321-322 

323 

199 

19 

10, 145 

196 

60 

124 

324 

60, 69 

362 

325 

326 

29 

327 

86 



392 



Index 



Subject Page 

Write Gate 88 

Write Precompensation 60, 69, 70 

Write Protect 84, 90, 95, 1 93 

WRNMIMASKREG* 28 
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@WRSEC 328 

@WRSSC 329 

@WRTRK 330 
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